HintedImageButton

ImageButton that shows hint using toast when long clicked

How to use?

• Add jitpack url in your root build.gradle

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

• Add the dependency

dependencies {
implementation 'com.github.hendrawd:HintedImageButton:x.x.x'
}

Where x.x.x is the latest release version. Check the latest release version here

• Use

<hendrawd.library.customview.HintedImageButton
android:layout_width="wrap_content"android:layout_height="wrap_content"android:src="@drawable/ic_xxx"android:contentDescription="Put your hint here!"android:background="@drawable/optional_selector"
/>
<!-- use android:background="@null" if you want to remove the background-->

Customization (see the example project for more clarity)

• Set duration

<hendrawd.library.customview.HintedImageButton
app:hintDuration="durationLong"
/>
<!-- "durationShort" or "durationLong", default="durationShort" -->

hintedImageButton.hintDuration =HintedImageButton.DURATION_LONG// or HintedImageButton.DURATION_SHORT

• Set custom layout

hintedImageButton.setCustomLayout(yourCustomLayout, yourTextView)

New Attribute in Android Oreo

Starting from Android Oreo, if your requirement is just to show simple tooltip to any View, you can use android:tooltipText attribute directly without this library in order to display a simple Toast-like tooltip when user long-presses or mouse hover on a View

<Viewandroid:id="@+id/yourView"android:tooltipText="@string/view_tooltip"/>

Although it has limitation with minimum API 26, you can still use it through the Support Library's TooltipCompat helper class

TooltipCompat.setTooltipText(yourView, getString(R.string.view_tooltip))

Have fun! ;)