fwith/android-simple-tooltip

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

Download

Step 1. Add the JitPack repository to your build file

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

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

Add it in your settings.gradle.kts at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url = uri("https://jitpack.io") }
		}
	}

Add to pom.xml

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.fwith:android-simple-tooltip:0.1.0'
	}
	dependencies {
		implementation("com.github.fwith:android-simple-tooltip:0.1.0")
	}
	<dependency>
	    <groupId>com.github.fwith</groupId>
	    <artifactId>android-simple-tooltip</artifactId>
	    <version>0.1.0</version>
	</dependency>

                            
    libraryDependencies += "com.github.fwith" % "android-simple-tooltip" % "0.1.0"
        
        

                            
    :dependencies [[com.github.fwith/android-simple-tooltip "0.1.0"]]

Readme

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

Usege

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

Contributions

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

Licence

The MIT License (MIT)

Copyright (c) 2016 Douglas Nassif Roma Junior

See complete on licence file.