工具提示是一种小型描述性消息,在用户长按视图或将鼠标悬停在视图上时显示在该视图附近。当你的应用使用图标表示操作或信息以节省布局空间时,这非常有用。本页介绍如何在 Android 8.0(API 级别 26)及更高版本中添加这些工具提示。
某些场景(例如生产力应用中的场景)需要一种描述性方法来传达想法和操作。你可以使用工具提示显示描述性消息,如图 1 所示。
图 1. 在 Android 应用中显示的工具提示。
一些标准微件根据 title
或 content description
属性的内容显示工具提示。从 Android 8.0 开始,你可以指定工具提示中显示的文本,无论其他属性的值如何。
设置工具提示文本
你可以通过调用 setTooltipText()
方法在 View
中指定工具提示文本。你可以使用相应的 XML 属性或 API 设置 tooltipText
属性。
要在 XML 文件中指定工具提示文本,请设置 android:tooltipText
属性,如下例所示:
<android.support.design.widget.FloatingActionButton
android:id="@+id/fab"
android:tooltipText="Send an email" />
要在代码中指定工具提示文本,请使用 setTooltipText(CharSequence)
方法,如下例所示:
Kotlin
val fab: FloatingActionButton = findViewById(R.id.fab) fab.tooltipText = "Send an email"
Java
FloatingActionButton fab = (FloatingActionButton) findViewById(R.id.fab); fab.setTooltipText("Send an email");
该 API 还包括一个 getTooltipText()
方法,你可以用它来检索 tooltipText
属性的值。
当用户将鼠标悬停在视图上或长按视图时,Android 会显示 tooltipText
属性的值。