工具提示

工具提示是在用户长按视图或将鼠标悬停在其上时出现在视图附近的简短描述性消息。当您的应用使用图标来表示操作或信息以节省布局空间时，这很有用。此页面向您展示如何在 Android 8.0（API 级别 26）及更高版本上添加这些工具提示。

某些场景（例如生产力应用中的场景）需要一种描述性的方法来传达想法和操作。您可以使用工具提示显示描述性消息，如图 1 所示。

tooltip screenshot

图 1. 在 Android 应用中显示的工具提示。

某些标准小部件根据title 或content description 属性的内容显示工具提示。从 Android 8.0 开始，您可以指定在工具提示中显示的文本，而不管其他属性的值。

您可以通过调用View 中的setTooltipText() 方法来指定View 中的工具提示文本。您可以使用相应的 XML 属性或 API 设置tooltipText 属性。

要在 XML 文件中指定工具提示文本，请设置android:tooltipText 属性，如下例所示

<android.support.design.widget.FloatingActionButton
        android:id="@+id/fab"
        android:tooltipText="Send an email" />

要在代码中指定工具提示文本，请使用setTooltipText(CharSequence) 方法，如下例所示

val fab: FloatingActionButton = findViewById(R.id.fab)
fab.tooltipText = "Send an email"

FloatingActionButton fab = (FloatingActionButton) findViewById(R.id.fab);
fab.setTooltipText("Send an email");

API 还包括一个getTooltipText() 方法，您可以使用它来检索tooltipText 属性的值。

当用户将鼠标悬停在视图上或长按视图时，Android 会显示tooltipText 属性的值。

设置工具提示文本