使用 Material 3 内边距

为了方便使用，许多内置的 Material 3 可组合项 (androidx.compose.material3) 会根据可组合项在应用中根据 Material 规范的放置方式自行处理边衬区。

注意： Material 2 组件 (androidx.compose.material) 本身并不会自动处理边衬区。不过，您可以获得边衬区的访问权限，然后手动应用边衬区。在 androidx.compose.material 1.6.0 及更高版本中，使用 windowInsets 参数可为 BottomAppBar、TopAppBar、BottomNavigation 以及 NavigationRail 手动应用边衬区。 同样，请为 Scaffold 使用 contentWindowInsets 参数。 否则，请手动应用边衬区作为内边距。

边衬区处理可组合项

以下是会自动处理边衬区的 Material 组件的列表。

应用栏

• TopAppBar/SmallTopAppBar/CenterAlignedTopAppBar/MediumTopAppBar/LargeTopAppBar：将系统栏的顶部和水平边用作内边距，因为此常量用于窗口顶部。
• BottomAppBar：将系统栏的底部和水平边用作内边距。

内容容器

• ModalDrawerSheet / DismissibleDrawerSheet / PermanentDrawerSheet（模态抽屉式导航栏内的内容）：向内容应用垂直和起始边衬区。
• ModalBottomSheet：应用底部边衬区。
• NavigationBar：应用底部和水平边衬区。
• NavigationRail：应用 vertical 和 start 边衬区。

Scaffold

默认情况下，Scaffold 提供插边作为参数 paddingValues，供您使用。 Scaffold 不会将边衬区应用于内容；这需要您自行负责。 例如，如需在 Scaffold 内使用 LazyColumn 来使用这些边衬区，请执行以下操作：

Scaffold { innerPadding ->
    // innerPadding contains inset information for you to use and apply
    LazyColumn(
        // consume insets as scaffold doesn't do it by default
        modifier = Modifier.consumeWindowInsets(innerPadding),
        contentPadding = innerPadding
    ) {
        // ..
    }
}
InsetsSnippets.kt

以下视频展示了 Scaffold 中的 LazyColumn，其中边到边显示处于停用和启用状态：

替换默认边衬区

您可以更改传递给可组合项的 windowInsets 参数，以配置可组合项的行为。此形参可以是要应用的另一种类型的窗口边衬区，也可以通过传递空实例 WindowInsets(0, 0, 0, 0) 来停用。

例如，如需在 LargeTopAppBar 上停用边衬区处理，请将 windowInsets 参数设置为空实例：

LargeTopAppBar(
    windowInsets = WindowInsets(0, 0, 0, 0),
    title = {
        Text("Hi")
    }
)
InsetsSnippets.kt