Show Case Card View

Additional

Language
Java
Version
0.0.4 (Jan 30, 2018)
Created
Jun 11, 2017
Updated
Feb 5, 2023 (Retired)
Owner
Dima Merkurev (dimorinny)
Contributors
Dima Merkurev (dimorinny)
Frank (Frank1234)
Heinrich 'Wess' Wesson (HeinrichWesson)
3
Activity
Badge
Generate
Download
Source code

Dependency

Firstly, add Jitpack repository in your root build.gradle file (not your module build.gradle file):

allprojects {
    repositories {
        ...
        maven { url "https://jitpack.io" }
    }
}

Add dependency to your module's build.gradle file:

dependencies {
    implementation 'com.github.dimorinny:show-case-card-view:0.0.4'
}

Usage

You can display a ShowCase on your activity or fragment using the below code.

To display a list of (click-through) steps:

new ShowCaseStepDisplayer.Builder(MainActivity.this)
    .addStep(new ShowCaseStep(new Center(), "Message at center"))
    .addStep(new ShowCaseStep(view, "Message at View"))
    .build().start();

Use withScrollView() if some step's target Views could be inside a ScrollView, they will be auto-scrolled to:

new ShowCaseStepDisplayer.Builder(MainActivity.this)
    .withScrollView(scrollView)
    .addStep(new ShowCaseStep(view, "Message at View to scroll to"))
    .addStep(new ShowCaseStep(new TopLeft(), "Message at TopLeft"))
    .build().start();

To display a single item:

new ShowCaseView.Builder(MainActivity.this)
    .withTypedPosition(new TopLeft())
    .withTypedRadius(new Radius(186F))
    .withContent("This is hello world!")
    .build()
    .show(this);

Available positions:

  • Position(PointF position)
  • TopLeft()
  • TopRight()
  • BottomLeft()
  • BottomRight()
  • TopLeftToolbar()
  • TopRightToolbar()
  • ViewPosition(View view)
  • Center()
  • BottomCenter()

Available radiuses:

  • Radius(float radius)
  • ViewRadius(View view)

For more complicated usage - see example.