分頁

分頁可讓您整理相關內容群組。分頁分為兩種：

  • 主要分頁：位於頂端應用程式列下方，內容窗格頂端。 這些標籤會顯示主要內容目的地，且僅需一組分頁時就應使用。
  • 次要分頁：用於內容區域內，進一步區隔相關內容並建立階層。如果畫面需要多個層級的分頁，就必須使用這些項目。
畫面顯示 3 個主要分頁，以及相關聯的圖示 (「航班」、「行程」和「探索」)。顯示 2 個次要分頁 (「總覽」、「規格」)，但沒有相關聯的圖示。
圖 1. 主要分頁 (1) 和次要分頁 (2)。

本頁面說明如何在應用程式中顯示主要分頁，以及相關畫面和基本導覽。

API 介面

使用 Tab、PrimaryTabRow 和 SecondaryTabRow 可組合函式實作分頁。Tab 可組合函式代表列中的個別分頁，通常用於 PrimaryTabRow (適用於主要指標分頁) 或 SecondaryTabRow (適用於次要指標分頁) 內。

Tab 包含下列重要參數：

  • selected：判斷目前分頁是否以視覺化方式醒目顯示。
  • onClick()：必要 lambda 函式，用於定義使用者點選分頁時要執行的動作。您通常會在這裡處理導覽事件、更新所選分頁的狀態，或載入相應內容。
  • text：在分頁中顯示文字。選用項目。
  • icon：在分頁中顯示圖示。選用項目。
  • enabled：控制是否啟用分頁，以及是否可與分頁互動。如果設為 false，分頁會顯示為已停用，且不會回應點擊動作。

示例：以分頁為基礎的導覽

下列程式碼片段會實作頂端導覽列，並使用分頁在應用程式的不同畫面之間導覽：

@Composable
fun NavigationTabExample(modifier: Modifier = Modifier) {
    val navController = rememberNavController()
    val startDestination = Destination.SONGS
    var selectedDestination by rememberSaveable { mutableIntStateOf(startDestination.ordinal) }

    Scaffold(modifier = modifier) { contentPadding ->
        PrimaryTabRow(selectedTabIndex = selectedDestination, modifier = Modifier.padding(contentPadding)) {
            Destination.entries.forEachIndexed { index, destination ->
                Tab(
                    selected = selectedDestination == index,
                    onClick = {
                        navController.navigate(route = destination.route)
                        selectedDestination = index
                    },
                    text = {
                        Text(
                            text = destination.label,
                            maxLines = 2,
                            overflow = TextOverflow.Ellipsis
                        )
                    }
                )
            }
        }
        AppNavHost(navController, startDestination)
    }
}
Navigation.kt

重點

  • PrimaryTabRow 會顯示一列橫向分頁，每個分頁都對應一個 Destination。
  • val navController = rememberNavController() 會建立並記住 NavHostController 的執行個體，用於管理 NavHost 內的導覽作業。
  • var selectedDestination by rememberSaveable { mutableIntStateOf(startDestination.ordinal) } 會管理所選分頁的狀態。
    • startDestination.ordinal 會取得 Destination.SONGS 列舉項目的數字索引 (位置)。
  • 點選分頁時，onClick lambda 會呼叫 navController.navigate(route = destination.route)，導覽至對應畫面。
  • Tab 的 onClick lambda 會更新 selectedDestination 狀態，以醒目顯示點選的分頁。
  • 它會呼叫 AppNavHost 可組合函式，並傳遞 navController 和 startDestination，以顯示所選畫面的實際內容。

結果

下圖顯示上一個程式碼片段的結果：

應用程式畫面頂端有 3 個橫向排列的分頁。分頁標籤包括「歌曲」、「專輯」和「播放清單」，其中「歌曲」分頁標籤已選取並加上底線。
圖 2. 3 個分頁標籤 (歌曲、專輯和播放清單) 會以水平方式排列。

其他資源