Scaffold

在 Material Design 中，基架是一种基本结构，可为复杂界面提供标准化平台。它将界面的不同部分（例如应用栏和悬浮操作按钮）整合在一起，使应用具有一致的外观和风格。

示例

Scaffold 可组合项提供了一个简单明了的 API，您可以使用该 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. 一个架构的实现。

其他资源