顯示頂端應用程式列

使用 TopAppBar 可組合項,建立頂端應用程式列,協助使用者瀏覽及存取應用程式中的函式。

版本相容性

這個實作方式需要將專案 minSDK 設為 API 級別 21 以上。

依附元件

為頂端應用程式列建立可組合函式

使用 MediumTopAppBar 可組合項建立頂端應用程式列,當使用者向下捲動內容區域時會收合,當使用者捲動回內容頂端時會展開:

程式碼的重點

  • 帶有 TopBar 集合的外部 Scaffold
  • 由單一 Text 元素組成的標題。
  • 頂端列已定義單一動作。
  • IconButton 動作,其中包含 onClick lambda 來執行動作。
  • IconButton 包含 Icon,其中含有圖示圖片和內容說明文字。
  • Scaffold 內部內容的捲動行為定義為 enterAlwaysScrollBehavior()。這樣一來,當使用者向上拉內部內容時,應用程式列就會收合,當使用者向下拉內部內容時,應用程式列就會展開。
  • 除了包含標題的 MediumTopBar 之外,您還可以使用:
    • TopAppBar:適用於不需要大量導覽或動作的畫面。
    • CenterAlignedTopAppBar:適用於具有單一主要動作的畫面。標題會置中顯示在元件中。
    • MediumTopAppBar:適用於需要適量導覽和操作的畫面。
    • LargeTopAppBar:適用於需要大量導覽和動作的畫面。使用比 MediumTopAppBar 更大的邊距,並將標題置於任何其他圖示下方。

結果

圖 1. 中型頂端應用程式列。

包含此指南的集合

本指南是精選的快速指南系列之一,涵蓋更廣泛的 Android 開發目標:

瞭解如何使用標準化平台建構複雜的使用者介面。這個結構體會將 UI 的不同部分結合在一起,讓應用程式呈現一致的外觀和風格。
瞭解可組合函式如何讓您輕鬆根據 Material Design 設計系統,建立美觀的 UI 元件。

有問題或意見回饋嗎?

歡迎前往常見問題頁面,瞭解快速指南或與我們聯絡,分享您的想法。