新增及處理動作

試試 Compose
Jetpack Compose 是 Android 推薦的 UI 工具包。瞭解如何在 Compose 中新增元件。
動態頂端應用程式列 →

您可以在應用程式列中新增使用者動作的按鈕。這項功能可讓您將目前情境中最重要的動作放在應用程式頂端。舉例來說，使用者瀏覽相片時，相片瀏覽應用程式可能會在頂端顯示「分享」和「建立相簿」按鈕。使用者查看個別相片時，應用程式可能會顯示「裁剪」和「濾鏡」按鈕。

應用程式列的空間有限，如果應用程式宣告的動作數量超過應用程式列可容納的數量，應用程式列會將多餘的動作傳送至溢位選單。應用程式也可以指定動作一律顯示在溢位選單中，而非應用程式列。

圖片：顯示 Now in Android 應用程式的畫面，以及動作列圖示
圖 1：「Now in Android」應用程式中的動作圖示。

新增動作按鈕

動作溢位中提供的所有動作按鈕和其他項目，都是在 XML 選單資源中定義。如要在動作列中新增動作，請在專案的 res/menu/ 目錄中建立新的 XML 檔案。

為要加入動作列的每個項目新增 <item> 元素，如下列選單 XML 範例檔案所示：

<menu xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto">

    <!-- "Mark Favorite", must appear as action button if possible. -->
    <item
        android:id="@+id/action_favorite"
        android:icon="@drawable/ic_favorite_black_48dp"
        android:title="@string/action_favorite"
        app:showAsAction="ifRoom"/>

    <!-- Settings, must always be in the overflow. -->
    <item android:id="@+id/action_settings"
          android:title="@string/action_settings"
          app:showAsAction="never"/>

</menu>

app:showAsAction 屬性會指定動作是否顯示為應用程式列上的按鈕。如果設定 app:showAsAction="ifRoom" (如範例程式碼的「favorite」動作)，應用程式列有空間時，動作會顯示為按鈕。如果空間不足，多餘的動作會傳送至溢位選單。如果您設定 app:showAsAction="never"，如範例程式碼的 settings 動作，動作一律會列在溢位選單中，不會顯示在應用程式列中。

如果動作顯示在應用程式列中，系統會使用動作的圖示做為動作按鈕。您可以在Material Icons 中找到許多實用圖示。

回覆動作

當使用者選取其中一個應用程式列項目時，系統會呼叫活動的 onOptionsItemSelected() 回呼方法，並傳遞 MenuItem 物件，指出點選的項目。實作 onOptionsItemSelected() 時，請呼叫 MenuItem.getItemId() 方法，判斷使用者輕觸的項目。傳回的 ID 會與您在相應 <item> 元素的 android:id 屬性中宣告的值相符。

舉例來說，下列程式碼片段會檢查使用者選取的動作。如果方法無法辨識使用者的動作，就會叫用超類別方法：

Kotlin

override fun onOptionsItemSelected(item: MenuItem) = when (item.itemId) {
    R.id.action_settings -> {
        // User chooses the "Settings" item. Show the app settings UI.
        true
    }

    R.id.action_favorite -> {
        // User chooses the "Favorite" action. Mark the current item as a
        // favorite.
        true
    }

    else -> {
        // The user's action isn't recognized.
        // Invoke the superclass to handle it.
        super.onOptionsItemSelected(item)
    }
}

Java

@Override
public boolean onOptionsItemSelected(MenuItem item) {
    switch (item.getItemId()) {
        case R.id.action_settings:
            // User chooses the "Settings" item. Show the app settings UI.
            return true;

        case R.id.action_favorite:
            // User chooses the "Favorite" action. Mark the current item as a
            // favorite.
            return true;

        default:
            // The user's action isn't recognized.
            // Invoke the superclass to handle it.
            return super.onOptionsItemSelected(item);

    }
}