Tooltips
Instructions
Add a dependency to your app build.gradle
dependencies {
implementation 'io.github.minyushov:tooltips:$version'
}
Please replace $version
with the latest version:
Create a ToolTipsManager
object
public class MainActivity extends Activity {
ToolTipsManager toolTipsManager;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
toolTipsManager = new ToolTipsManager();
}
}
Use the ToolTip.Builder
to construct your tip
public class MainActivity extends Activity {
@Override
public void onWindowFocusChanged(boolean hasFocus) {
super.onWindowFocusChanged(hasFocus);
ToolTip.Builder builder = new ToolTip.Builder(this, textView, rootLayout, "Tip message", ToolTip.POSITION_ABOVE);
}
}
textView
here is the view which near it the tip will be shown and rootLayout
is the layout where the tip view will be added to. The root layout must be of RelativeLayout
, FrameLayout
or similar. LinearLayout
won't work but you can always wrap your LinearLayout
with another layout. Prefer to pass in a layout which is higher in the xml tree as this will give the tip view more visible space.
OPTIONAL: Customize your tip with background color, text color, alignment, text gravity, type face and more.
public class MainActivity extends Activity {
@Override
public void onWindowFocusChanged(boolean hasFocus) {
super.onWindowFocusChanged(hasFocus);
ToolTip.Builder builder = new ToolTip.Builder(this, textView, rootLayout, "Tip message", ToolTip.POSITION_ABOVE);
builder.setAlign(ToolTip.ALIGN_LEFT);
builder.setBackgroundColor(getResources().getColor(R.color.colorOrange));
builder.setGravity(ToolTip.GRAVITY_RIGHT);
builder.setTextAppearance(R.style.TextAppearance_Tooltip); // from `styles.xml`
builder.setTypeface(customFontTypeface);
}
}
Here is an example on how you can define your text appearance in your styles.xml
<style name="TextAppearance.Tooltip">
<item name="android:textColor">@color/your_custom_color</item>
<item name="android:textSize">16sp</item>
<item name="android:textStyle">bold</item>
</style>
You can also customize the animation used to show and hide the tooltip view by providing ToolTipAnimator
implementation and setting it in the ToolTipsManager
.
public class MainActivity extends Activity {
ToolTipsManager toolTipsManager;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
toolTipsManager = new ToolTipsManager();
toolTipsManager.setToolTipAnimator(MyCustomToolTipAnimator());
}
}
Use ToolTipManger
to show the tip
IMPORTANT: This must be called after the layout has been drawn You can override the onWindowFocusChanged()
of an Activity and show there, Start a delayed runnable from onStart()
, react to user action or any other method that works for you
public class MainActivity extends Activity {
@Override
public void onWindowFocusChanged(boolean hasFocus) {
super.onWindowFocusChanged(hasFocus);
ToolTip.Builder builder = new ToolTip.Builder(this, textView, rootLayout, "Tip message", ToolTip.POSITION_ABOVE);
// Rest of builder configurations removed for brevity
toolTipsManager.show(builder.build());
}
}
Each tip is dismissable by clicking on it, if you want to dismiss a tip from code there are a few options, the most simple way is to do the following
public class MainActivity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
dismissButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
toolTipsManager.findAndDismiss(textView);
}
});
}
}
Where textView
is the same view we asked to position a tip near it
If you want to react when tip has been dismissed, Implement ToolTipsManager.TipListener
interface and use appropriate ToolTipsManager
constructor
public class MainActivity extends Activity implements ToolTipsManager.TipListener {
@Override
protected void onCreate(Bundle savedInstanceState) {
toolTipsManager = new ToolTipsManager(this);
}
@Override
public void onTipDismissed(View view, int anchorViewId, boolean byUser) {
Log.d(TAG, "tip near anchor view " + anchorViewId + " dismissed");
if (anchorViewId == R.id.text_view) {
// Do something when a tip near view with id "R.id.text_view" has been dismissed
}
}
}
License
Copyright 2016 Tomer Goldstein
Copyright 2021 Semyon Minyushov
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.