Skip to content

yeyinlin/Spotlight

 
 

Repository files navigation

Spotlight

Spotlight is a android library to onboard user by showcasing specific features in the app.

Platform API Android Arsenal

#Screen

#Usage

 new SpotlightView.Builder(this)
                .setRevealAnimationDuration(400)
                .enableRevalAnimation(isRevealEnabled)
                .performClick(true)
                .fadinTextDuration(400)
                .headingTvColor(Color.parseColor("#eb273f"))
                .headingTvSize(32)
                .headingTvText("Love")
                .subHeadingTvColor(Color.parseColor("#ffffff"))
                .subHeadingTvSize(16)
                .subHeadingTvText("Like the picture?\nLet others know.")
                .setMaskColor(Color.parseColor("#dc000000"))
                .setTarget(view)
                .lineAnimDuration(400)
                .lineAndArcColor(Color.parseColor("#eb273f"))
                .dismissOnTouch(true)
                .setUsageId(usageId)
                .show();

Download

Gradle

  1. Add it in your root build.gradle at the end of repositories:

    allprojects {
    	repositories {
    		...
    		maven { url "https://jitpack.io" }
    	}
    }
  2. Add the dependency

    dependencies {
        compile 'com.github.wooplr:Spotlight:1.0'
    }

Maven

  1. Add it in your pom.xml at the end of repositories:

    <repositories>
        ...
    	<repository>
    	    <id>jitpack.io</id>
    	    <url>https://jitpack.io</url>
    	</repository>
    </repositories>
  2. Add the dependency

    <dependency>
        <groupId>com.github.wooplr</groupId>
        <artifactId>Spotlight</artifactId>
        <version>1.0</version>
    </dependency>

Builder Methods

maskColor(int)

Overlay Color

target(View)

View to showcase

introAnimationDuration(long)

Intro animation duration (For Reveal and Fadein)

enableRevalAnimation(boolean)

Enable reval animation (Only for Lollipop and above)

fadeinTextDuration(long)

Fade in animation duration for spotlight text (Heading and Sub-heading)

headingTvSize(int)

Size of heading text

headingTvColor(int)

Color of heading text

headingTvText(CharSequence)

Text to display in heading

subHeadingTvSize(int)

Size of sub-heading text

subHeadingTvColor(int)

Color of sub-heading text

subHeadingTvText(CharSequence)

Text to display in sub-heading

setTypeface(Typeface)

Custom font for text in spotlight view

lineAndArcColor(int)

Color of the spotlight line

lineAnimDuration(long)

Line animation duration

performClick(boolean)

Perform a click on target view

usageId(String)

Unique id for each spotlight

dismissOnTouch(boolean)

Dismiss spotlight on touch outside

Configuration Method

//Create global config instance to reuse it
SpotlightConfig config = new SpotlightConfig();
config.isDismissOnTouch(true);
config.setLineAndArcColor(0xFFFFFFFF);
...
.setConfiguration(config) //

#Author

Jitender Chaudhary

#Credits MaterialIntroView

Rahul Khanna

Suraj Barthy

License

Apache 2.0

About

Spotlight is a android library to onboard user by showcasing specific features in the app.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 100.0%