Scaffold

在 Material Design 中，結構體是基本結構，可為複雜的使用者介面提供標準化平台。它會將 UI 的不同部分 (例如應用程式列和懸浮動作按鈕) 結合在一起，為應用程式提供一致的外觀和感受。

範例

Scaffold 可組合函式提供簡單的 API，可用於根據 Material Design 指南快速組合應用程式結構。Scaffold 可接受多個可組合函式做為參數。其中包括：

  • topBar：位於螢幕頂端的應用程式列。
  • bottomBar：橫跨螢幕底部的應用程式列。
  • floatingActionButton：這個按鈕會懸停在螢幕的右下角，可用來顯示主要動作。

如需有關如何實作頂端和底部應用程式列的詳細範例，請參閱應用程式列頁面。

您也可以將 Scaffold 內容傳遞至其他容器。它會將 innerPadding 值傳遞至 content lambda，您可以在子項可組合函式中使用該值。

以下範例提供完整範例，說明如何實作 Scaffold。其中包含頂端應用程式列、底部應用程式列，以及與 Scaffold 內部狀態互動的浮動動作按鈕。

@Composable
fun ScaffoldExample() {
    var presses by remember { mutableIntStateOf(0) }

    Scaffold(
        topBar = {
            TopAppBar(
                colors = topAppBarColors(
                    containerColor = MaterialTheme.colorScheme.primaryContainer,
                    titleContentColor = MaterialTheme.colorScheme.primary,
                ),
                title = {
                    Text("Top app bar")
                }
            )
        },
        bottomBar = {
            BottomAppBar(
                containerColor = MaterialTheme.colorScheme.primaryContainer,
                contentColor = MaterialTheme.colorScheme.primary,
            ) {
                Text(
                    modifier = Modifier
                        .fillMaxWidth(),
                    textAlign = TextAlign.Center,
                    text = "Bottom app bar",
                )
            }
        },
        floatingActionButton = {
            FloatingActionButton(onClick = { presses++ }) {
                Icon(Icons.Default.Add, contentDescription = "Add")
            }
        }
    ) { innerPadding ->
        Column(
            modifier = Modifier
                .padding(innerPadding),
            verticalArrangement = Arrangement.spacedBy(16.dp),
        ) {
            Text(
                modifier = Modifier.padding(8.dp),
                text =
                """
                    This is an example of a scaffold. It uses the Scaffold composable's parameters to create a screen with a simple top app bar, bottom app bar, and floating action button.

                    It also contains some basic inner content, such as this text.

                    You have pressed the floating action button $presses times.
                """.trimIndent(),
            )
        }
    }
}
Scaffold.kt

此實作方式如下所示：

此範例實作了包含簡單頂端和底部應用程式列的架構，以及可重複執行計數器的懸浮動作按鈕。骨架的內部內容是簡單的文字，用於說明元件。
圖 1. 架構的實作。

其他資源