工具提示

Stay organized with collections Save and categorize content based on your preferences.

工具提示是簡短的描述性訊息,當使用者長按檢視區塊或將滑鼠遊標懸停在檢視區塊上時,旁邊就會顯示提示訊息。如果應用程式使用圖示來呈現動作或資訊,以便節省版面配置中的空間,這個方法就很有用。本頁面說明如何在 Android 8.0 (API 級別 26) 及以上版本中新增工具提示。

在某些情境下 (例如在效率提升應用程式中),需要以描述性的方式來傳達想法和動作。您可以使用工具提示來顯示描述性訊息,如圖 1 所示。

工具提示螢幕截圖

圖 1. Android 應用程式中顯示的工具提示。

部分標準小工具會根據 titlecontent 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 屬性的值。