A simple library based on PopupWindow to create Tooltips on Android. ❤️
Java
Latest commit 35c71dd Oct 17, 2016 @douglasjunior travis update
Permalink
Failed to load latest commit information.
gradle/wrapper Gradle update Oct 17, 2016
library travis update Oct 17, 2016
sample travis update Oct 17, 2016
screenshots Add demo.gif May 10, 2016
.gitignore first commit May 10, 2016
.travis.yml travis update Oct 17, 2016
LICENSE Initial commit May 10, 2016
README.md Readme Sep 2, 2016
README.pt.md Readme Sep 2, 2016
build.gradle Gradle update Oct 17, 2016
gradle.properties first commit May 10, 2016
gradlew first commit May 10, 2016
gradlew.bat first commit May 10, 2016
settings.gradle first commit May 10, 2016

README.md

Android Simple Tooltip

PT

Licence MIT Build Status Release Android Arsenal

A simple library based on PopupWindow to create Tooltips on Android.

Features

  • Working from Android 2.1 (API 7) Note: animation above 3.0 (API 11)
  • Simple to use: few parameters in a single line of code
  • Animation with speed and size control
  • Option to close with touch inside or outside of the tooltip.
  • Modal mode (prevents touch in the background)
  • Overlay (darkens the background highlighting the anchor)
  • Customizable arrow
  • Inflatable content from a View or XML layout.
  • Colors and dimensions customized by Builder or XML resources

Demo

Demo

Usage

Basic

View yourView = findViewById(R.id.your_view);

new SimpleTooltip.Builder(this)
    .anchorView(yourView)
    .text("Texto do Tooltip")
    .gravity(Gravity.END)
    .animated(true)
    .transparentOverlay(false)
    .build()
    .show();

Resources

<color name="simpletooltip_background">@color/colorAccent</color>
<color name="simpletooltip_text">@android:color/primary_text_light</color>
<color name="simpletooltip_arrow">@color/colorAccent</color>
<dimen name="simpletooltip_max_width">150dp</dimen>
<dimen name="simpletooltip_overlay_circle_offset">10dp</dimen>
<dimen name="simpletooltip_margin">10dp</dimen>
<dimen name="simpletooltip_padding">8dp</dimen>
<dimen name="simpletooltip_arrow_width">30dp</dimen>
<dimen name="simpletooltip_arrow_height">15dp</dimen>
<dimen name="simpletooltip_animation_padding">4dp</dimen>
<integer name="simpletooltip_overlay_alpha">120</integer>
<integer name="simpletooltip_animation_duration">800</integer>
<style name="simpletooltip_default" parent="@android:style/TextAppearance.Medium"></style>

More info on the sample project and javadoc.

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.douglasjunior:android-simple-tooltip:0.1.2'
    }

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.douglasjunior</groupId>
        <artifactId>android-simple-tooltip</artifactId>
        <version>0.1.2</version>
    </dependency>

Snapshot

dependencies {
    compile('com.github.douglasjunior:android-simple-tooltip:master-SNAPSHOT') {
        changing = true // Gradle will then check for updates every 24 hours
    }
}

or

<dependency>
    <groupId>com.github.douglasjunior</groupId>
    <artifactId>android-simple-tooltip</artifactId>
    <version>master-SNAPSHOT</version>
</dependency>

Donate

Donate

Contribute

New features, bug fixes and improvements in the translation are welcome! For questions and suggestions use the issues.

Before submit your PR, run the gradle check.

./gradlew build connectedCheck

Known issues

  1. If you close the Dialog/Activity without the Tooltip is closed, there may be the exception java.lang.IllegalArgumentException: Could not lock surface. This error occurs because the animation continue for a while after closing the Dialog/Activity. (This error does not impact the execution of the app)

  2. If you call tooltip.show() after Activity/Dialog is closed, there may be the exception android.view.WindowLeaked: Activity has leaked window android.widget.PopupWindow$PopupViewContainer that was originally added here. Read more. (This error does not impact the execution of the app)

Licence

The MIT License (MIT)

Copyright (c) 2016 Douglas Nassif Roma Junior

See the full licence file.