設定應用程式列

嘗試 Compose 方法
Jetpack Compose 是 Android 推薦的 UI 工具包。瞭解如何在 Compose 中新增元件。

在最基本的介面中,動作列會在一側顯示活動的標題,另一側顯示溢位選單。即使是這種基本格式,應用程式列仍會為使用者提供實用資訊,並讓 Android 應用程式擁有一致的外觀和風格。

這張圖片顯示 Now in Android 應用程式中的應用程式列
圖 1:應用程式列含有「Now in Android」應用程式中的動作圖示。

所有使用預設主題的活動都有 ActionBar 做為應用程式列。許多 Android 版本都會在原生 ActionBar 中加入應用程式列功能。因此,原生 ActionBar 的行為會因裝置使用的 Android 版本而異。

另一方面,功能會新增至 AndroidX AppCompat 程式庫版本的 Toolbar,這表示使用 AndroidX 程式庫的裝置也能使用這些功能。

因此,請使用 AndroidX 程式庫的 Toolbar 類別,實作活動的應用程式列。使用 AndroidX 程式庫的工具列,即可讓各種裝置的使用者行為保持一致。

在活動中新增工具列

以下步驟說明如何將 Toolbar 設為活動的應用程式列:
  1. 按照 AndroidX 總覽所述,將 AndroidX 程式庫新增至專案。
  2. 確認活動擴充 AppCompatActivity

    Kotlin

    class MyActivity : AppCompatActivity() {
      // ...
    }
    

    Java

    public class MyActivity extends AppCompatActivity {
      // ...
    }
    
  3. 在應用程式資訊清單中,將 <application> 元素設為使用 AppCompat 的 NoActionBar 主題,如以下範例所示。使用其中一個主題會禁止應用程式使用原生 ActionBar 類別提供應用程式列。
    <application
        android:theme="@style/Theme.AppCompat.Light.NoActionBar"
        />
    
  4. 在活動的版面配置中加入 Toolbar。舉例來說,下列版面配置程式碼會新增 Toolbar,並使其在活動上方出現浮動外觀:
    <androidx.appcompat.widget.Toolbar
       android:id="@+id/my_toolbar"
       android:layout_width="match_parent"
       android:layout_height="?attr/actionBarSize"
       android:background="?attr/colorPrimary"
       android:elevation="4dp"
       android:theme="@style/ThemeOverlay.AppCompat.ActionBar"
       app:popupTheme="@style/ThemeOverlay.AppCompat.Light"/>
    

    如需應用程式列高度建議,請參閱 Material Design 規格

    請將工具列置於活動版面配置的頂端,因為您將工具列當做應用程式列使用。

  5. 在活動的 onCreate() 方法中,呼叫活動的 setSupportActionBar() 方法並傳遞活動的工具列,如以下範例所示。這個方法會將工具列設為活動的應用程式列。

    Kotlin

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_my)
        // The Toolbar defined in the layout has the id "my_toolbar".
        setSupportActionBar(findViewById(R.id.my_toolbar))
    }
    

    Java

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_my);
        Toolbar myToolbar = (Toolbar) findViewById(R.id.my_toolbar);
        setSupportActionBar(myToolbar);
    }
    

您的應用程式現在有基本的動作列。根據預設,動作列會包含應用程式名稱和溢位選單,其中一開始含有「設定」項目。您可以在動作列和溢位選單中加入更多動作,如「新增及處理動作」一文所述。

使用應用程式列公用程式方法

將工具列設為活動的應用程式列後,即可存取 AndroidX 程式庫 ActionBar 類別提供的公用程式方法。這個方法可讓您執行一些實用操作,例如隱藏及顯示應用程式列。

如要使用 ActionBar 公用程式方法,請呼叫活動的 getSupportActionBar() 方法。這個方法會傳回 AppCompat ActionBar 物件的參照。取得該參照項目後,您可以呼叫任何 ActionBar 方法來調整應用程式列。舉例來說,如要隱藏應用程式列,請呼叫 ActionBar.hide()