Android Tooltips

Simple to use customizable Android Tooltips library based on PopupWindow. This Tooltips does not require any custom layout. It works as PopupWindow.

Getting started

SNAPSHOTS

For using snapshots of development versions you need include the snapshots repo by adding the snapshot build to a dependent project. To do this add the following to your build.gradle project(not module) file

maven {
    url "https://oss.sonatype.org/content/repositories/snapshots"
}

Gradle

dependencies {
    compile 'com.github.vihtarb:tooltip:1.0.0-alpha05-SNAPSHOT'
}

Maven

<dependency>
    <groupId>com.github.vihtarb</groupId>
    <artifactId>tooltip</artifactId>
    <version>1.0.0-alpha05-SNAPSHOT</version>
</dependency>

Changelog-SNAPSHOTS

1.0.0-alpha05-SNAPSHOT

• Fixed #58 issue
• Removed android:fontFamily and android:typeface attributes support for simple Tooltip. Use textAppearance instead
• Removed deprecated classes from simple Tooltip module
• Implemented tooltipStyle attribute

1.0.0-alpha04-SNAPSHOT

• Fixed #57 issue

1.0.0-alpha03-SNAPSHOT

• Migrated to androidx

1.0.0-alpha02-SNAPSHOT

• Migrated to Java 1.8
• Fixed simple Tooltip Builder.setText(int) method
• Implemented sets Tooltip setFocusable(isCancelable) issue #55

1.0.0-alpha01-SNAPSHOT

• Library splitted to core and default Tooltip modules.
• First version with a primitive implementation of customization. From this version you can customize tooltip as you need. To do this you need extends from core.Tooltip and core.Tooltip.Builder classes and implement core.Tooltip.createContentView method. For example look to detault Tooltip implementation.

USAGE

Tooltip tooltip = new Tooltip.Builder(anchorView)
        .setText("Hello tooltip")
        .show();

Useful methods

Builder:

• Builder(MenuItem anchorMenuItem)
• Builder(MenuItem anchorMenuItem, @StyleRes int resId)
• Builder(View anchorView)
• Builder(View anchorView, @StyleRes int resId)
• setCancelable(boolean cancelable) - dismiss on outside touch. Default is false
• setDismissOnClick(boolean isDissmissOnClick) - dismiss on inside touch. Default is false
• setArrowEnabled(boolean isArrowEnabled)
• setBackgroundColor(@ColorInt int color) - background color. Default is Color.GRAY
• setCornerRadius(@DimenRes int resId) - background drawable corner radius from resources
• setCornerRadius(float radius) - background drawable corner radius
• setArrowHeight(@DimenRes int resId)
• setArrowHeight(float height)
• setArrowWidth(@DimenRes int resId)
• setArrowWidth(float width)
• setArrow(@DrawableRes int resId) - custom arrow drawable from resources
• setArrow(Drawable arrowDrawable) - custom arrow drawable
• setMargin(@DimenRes int resId) - margin between arrow and anchor view from resources
• setMargin(float margin) - margin between arrow and anchor view
• setPadding(int padding) - content padding
• setPadding(float padding) - deprecated, use setPadding(int padding) instead
• setGravity(int gravity) - Tooltip gravity. Default is Gravity.BOTTOM
• setMaxWidth(int gravity)
• setDrawablePadding(int gravity)
• setDrawableBottom(@DrawableRes int resId)
• setDrawableBottom(Drawable drawable)
• setDrawableEnd(@DrawableRes int resId)
• setDrawableEnd(Drawable drawable)
• setDrawableStart(@DrawableRes int resId)
• setDrawableStart(Drawable drawable)
• setDrawableTop(@DrawableRes int resId)
• setDrawableTop(Drawable drawable)
• setTextAppearance(@StyleRes int resId)
• setText(@StringRes int resId)
• setText(String text)
• setTextSize(@DimenRes int resId)
• setTextSize(float size)
• setTextColor(@ColorInt int color)
• setTextStyle(int style)
• setLineSpacing(@DimenRes int addResId, float mult)
• setLineSpacing(float add, float mult)
• setTypeface(Typeface typeface)
• setOnClickListener(OnClickListener listener)
• setOnLongClickListener(OnLongClickListener listener)
• setOnDismissListener(OnDismissListener listener)
• build() - creates and returns new Tooltip
• show() - creates, shows and returns new Tooltip

Tooltip:

• isShowing() - retruns is Tooltip showing
• show() - show Tooltip if not showing
• dismiss() - dismissing Tooltip
• setOnClickListener(OnClickListener listener)
• setOnLongClickListener(OnLongClickListener listener)
• setOnDismissListener(OnDismissListener listener)

Styleable

You can create Tooltip with custom style

Tooltip tooltip = new Tooltip.Builder(anchorView, R.style.tooltip)
        .setText("Hello tooltip")
        .show();

Attributes

• <attr name="cancelable" format="boolean"/> - dismiss on outside touch. Default is false
• <attr name="dismissOnClick" format="boolean"/> - dismiss on inside touch. Default is false
• <attr name="arrowEnabled" format="boolean"/>
• <attr name="backgroundColor" format="color"/> - background color. Default is Color.GRAY
• <attr name="cornerRadius" format="dimension"/> - background drawable corner radius
• <attr name="arrowHeight" format="dimension"/>
• <attr name="arrowWidth" format="dimension"/>
• <attr name="arrowDrawable" format="reference"/>
• <attr name="margin" format="dimension"/> - margin between arrow and anchor view
• <attr name="textAppearance" format="reference"/>
• <attr name="android:padding"/> - content padding
• <attr name="android:gravity"/> - Tooltip gravity
• <attr name="android:maxWidth"/>
• <attr name="android:drawablePadding"/>
• <attr name="android:drawableBottom"/>
• <attr name="android:drawableEnd"/>
• <attr name="android:drawableStart"/>
• <attr name="android:drawableTop"/>
• <attr name="android:text"/>
• <attr name="android:textSize"/>
• <attr name="android:textColor"/>
• <attr name="android:textStyle"/>
• <attr name="android:fontFamily"/>
• <attr name="android:typeface"/>
• <attr name="android:lineSpacingExtra"/>
• <attr name="android:lineSpacingMultiplier"/>

RELEASES

Gradle

dependencies {
    compile 'com.github.vihtarb:tooltip:0.2.0'
}

Maven

<dependency>
    <groupId>com.github.vihtarb</groupId>
    <artifactId>tooltip</artifactId>
    <version>0.2.0</version>
</dependency>

Changelog

0.2.0

• Implemented setting compound drawables(and drawables padding) by Builder methods setDrawableStart, setDrawableEnd, setDrawableBottom, setDrawableTop and for padding setDrawablePadding(int) or styleable attributes android:drawableStart, android:drawableEnd, android:drawableBottom, android:drawableTop and for padding android:drawablePadding (@antoninovitale)
• Implemented setting max Tooltip width by Builder method setMaxWidth(int) or styleable attribute android:maxWidth (@CapnSpellcheck)
• Implemented RTL layout direction supporting
• Implemented use Gravity.LEFT and Gravity.RIGHT as Tooltip gravity, but it strongly not recommended
• Implemented smooth Tooltip arrow
• Fixed Tooltip content view padding
• Builder method setPadding(float) marked as deprecated use setPadding(int) instead
• Builder method setPadding(int) now sets padding from argument not from resources
• Implemented arrow disabling by Builder method setArrowEnabled(boolean) or styleable attribute arrowEnabled
• #26 Fixed issue with Exception android.view.WindowManager$BadTokenException:...
• #19 Fixed issue with Tooltip moving on scrolling/updating list views
• #13 Implemented supporting CharSequence for text instead of String (@gkravas)

0.1.9

• Min SDK changed from 11 to 14
• Implemented OnClickListener and OnLongClickListener listeners
• Implemented setOnClickListener and setOnLongClickListener methods in Builder and Tooltip
• Implemented setOnDismissListener in Tooltip
• Implemented customizing arrow drawable by Builder method setArrow(Drawable) and styleable attribute arrowDrawable
• Reimplemented TooltipActionView class
• Removed Context context argument in Builder constructors with second argument MenuItem anchorMenuItem
• Fixed Activity has leaked window

Future Work

• Animations
• Elevation(Shadow)

Known issues

• #17 As temporary fix use it: compile ('com.github.vihtarb:tooltip:version') { exclude module: "support-compat" }

License(MIT License)

The MIT License (MIT)

Copyright (c) 2016. Viн[email protected]ь

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.