本頁面由 Cloud Translation API 翻譯而成。

工具提示

工具提示是簡短的描述性訊息，會在使用者長按檢視區塊，或將遊標懸停在其上方。如果應用程式使用圖示來代表動作或資訊，進而節省版面配置。本頁說明如何在 Android 8.0 (API 級別) 中新增工具提示 26) 以上版本。

在某些情境下 (例如在效率提升應用程式中)，就需要使用描述性方法是溝通創意和行動的不二法門您可以使用工具提示來顯示描述性訊息，如圖 1 所示。

工具提示螢幕截圖

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

部分標準小工具會根據 title 的內容或 content description 屬性。從 Android 8.0 開始，您可以指定顯示的任何文字，無論其他屬性的值為何。

如要在 View 中指定工具提示文字，請呼叫 setTooltipText() 方法。您可以設定透過相應的 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 屬性的值。

當使用者將遊標懸停在 tooltipText 屬性值時，Android 就會顯示將滑鼠遊標停在檢視畫面上或長按檢視畫面

設定工具提示文字