应用栏

应用栏是一种容器,可让用户访问关键功能和导航项。应用栏分为两种:顶部应用栏和底部应用栏。它们各自的外观和用途如下:

类型

外观

用途

顶部应用栏

在屏幕顶部。

提供对关键任务和信息的访问权限。通常用于托管标题、核心操作项和某些导航项。

底部应用栏

在屏幕底部。

通常包含核心导航项。还可以提供对其他关键操作的访问权限,例如通过所含的悬浮操作按钮。

顶部和底部应用栏示例。
图 1. 顶部应用栏(左)和底部应用栏(右)。

如需实现顶部应用栏和底部应用栏,请分别使用 TopAppBarBottomAppBar 可组合项。借助它们,您可以创建封装导航和操作控件的一致界面,并符合 Material Design 原则。

顶部应用栏

下表概述了四种顶部应用栏:

类型

示例

:适用于不需要大量导航或操作的界面。

小型顶部应用栏

居中对齐:适用于只有一个主要操作的界面。

居中对齐的顶部应用栏

:适用于需要适度导航和操作的屏幕。

中等顶部应用栏

:适用于需要大量导航和操作的屏幕。

大型顶部应用栏

API Surface

用于实现四种不同顶部应用栏的各种可组合项非常相似。它们有几个共同的关键参数:

  • title:应用栏中显示的文本。
  • navigationIcon:导航的主要图标。显示在应用栏的左侧。
  • actions:用于向用户提供对关键操作的访问权限的图标。它们显示在应用栏的右侧。
  • scrollBehavior:确定顶部应用栏如何响应 Scaffold 内部内容的滚动。
  • colors:确定应用栏的显示方式。

滚动行为

您可以控制当用户滚动给定 Scaffold 的内部内容时,应用栏如何响应。为此,请创建一个 TopAppBarScrollBehavior 实例,并将其传递给顶部应用栏中的 scrollBehavior 参数。

TopAppBarScrollBehavior 有三种类型。如下所示:

  • enterAlwaysScrollBehavior:当用户拉出 Scaffold 的内部分内容时,顶部应用栏会收起。当用户向下拉动内部内容时,应用栏会展开。
  • exitUntilCollapsedScrollBehavior:与 enterAlwaysScrollBehavior 类似,不过当用户到达 Scaffold 内部内容的末尾时,应用栏会额外展开。
  • pinnedScrollBehavior:应用栏保持原位,不对滚动做出响应。

以下示例实现了其中的几个选项。

示例

以下部分提供了四种不同类型的顶部应用栏的实现,包括有关如何控制滚动行为的不同示例。

如需创建小型顶部应用栏,请使用 TopAppBar 可组合项。这是尽可能简单的顶部应用栏,在此示例中,它只包含一个标题。

以下示例未向 TopAppBar 传递 scrollBehavior 的值,因此不会对内部内容的滚动做出响应。

@Composable
fun SmallTopAppBarExample() {
    Scaffold(
        topBar = {
            TopAppBar(
                colors = TopAppBarDefaults.topAppBarColors(
                    containerColor = MaterialTheme.colorScheme.primaryContainer,
                    titleContentColor = MaterialTheme.colorScheme.primary,
                ),
                title = {
                    Text("Small Top App Bar")
                }
            )
        },
    ) { innerPadding ->
        ScrollContent(innerPadding)
    }
}

此实现如下所示:

小型顶部应用栏示例。
图 2. 一个小型顶部应用栏。

已居中对齐

居中对齐的顶部应用栏与小应用栏基本相同,但标题会居中显示在组件中。如需实现它,请使用专用的 CenterAlignedTopAppBar 可组合项。

此示例使用 enterAlwaysScrollBehavior() 获取它为 scrollBehavior 传递的值。因此,当用户滚动框架的内部内容时,该栏会收起。

@Composable
fun CenterAlignedTopAppBarExample() {
    val scrollBehavior = TopAppBarDefaults.pinnedScrollBehavior(rememberTopAppBarState())

    Scaffold(
        modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection),

        topBar = {
            CenterAlignedTopAppBar(
                colors = TopAppBarDefaults.centerAlignedTopAppBarColors(
                    containerColor = MaterialTheme.colorScheme.primaryContainer,
                    titleContentColor = MaterialTheme.colorScheme.primary,
                ),
                title = {
                    Text(
                        "Centered Top App Bar",
                        maxLines = 1,
                        overflow = TextOverflow.Ellipsis
                    )
                },
                navigationIcon = {
                    IconButton(onClick = { /* do something */ }) {
                        Icon(
                            imageVector = Icons.AutoMirrored.Filled.ArrowBack,
                            contentDescription = "Localized description"
                        )
                    }
                },
                actions = {
                    IconButton(onClick = { /* do something */ }) {
                        Icon(
                            imageVector = Icons.Filled.Menu,
                            contentDescription = "Localized description"
                        )
                    }
                },
                scrollBehavior = scrollBehavior,
            )
        },
    ) { innerPadding ->
        ScrollContent(innerPadding)
    }
}

此实现如下所示:

在此处输入替代文本
图 3. 居中对齐的顶部应用栏。

中等顶部应用栏会将标题放置在所有其他图标下方。如需创建一个,请使用 MediumTopAppBar 可组合项。

与上一个代码段一样,此示例使用 enterAlwaysScrollBehavior() 来获取它为 scrollBehavior 传递的值。

@Composable
fun MediumTopAppBarExample() {
    val scrollBehavior = TopAppBarDefaults.enterAlwaysScrollBehavior(rememberTopAppBarState())

    Scaffold(
        modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection),
        topBar = {
            MediumTopAppBar(
                colors = TopAppBarDefaults.topAppBarColors(
                    containerColor = MaterialTheme.colorScheme.primaryContainer,
                    titleContentColor = MaterialTheme.colorScheme.primary,
                ),
                title = {
                    Text(
                        "Medium Top App Bar",
                        maxLines = 1,
                        overflow = TextOverflow.Ellipsis
                    )
                },
                navigationIcon = {
                    IconButton(onClick = { /* do something */ }) {
                        Icon(
                            imageVector = Icons.AutoMirrored.Filled.ArrowBack,
                            contentDescription = "Localized description"
                        )
                    }
                },
                actions = {
                    IconButton(onClick = { /* do something */ }) {
                        Icon(
                            imageVector = Icons.Filled.Menu,
                            contentDescription = "Localized description"
                        )
                    }
                },
                scrollBehavior = scrollBehavior
            )
        },
    ) { innerPadding ->
        ScrollContent(innerPadding)
    }
}

此实现如下所示,演示了 enterAlwaysScrollBehavior() 中的滚动行为如何显示:

图 4. 居中对齐的顶部应用栏。

大号顶部应用栏与中号应用栏类似,但标题和图标之间的内边距更大,并且在屏幕上占据的总空间也更大。如需创建这样的实现,请使用 LargeTopAppBar 可组合项。

与前面的代码段不同,此示例使用 exitUntilCollapsedScrollBehavior() 获取要传递给 scrollBehavior 的值。因此,当用户滚动 Scaffold 的内部内容时,该栏会收起,然后在用户滚动到内部内容末尾时展开。

@Composable
fun LargeTopAppBarExample() {
    val scrollBehavior = TopAppBarDefaults.exitUntilCollapsedScrollBehavior(rememberTopAppBarState())

    Scaffold(
        modifier = Modifier.nestedScroll(scrollBehavior.nestedScrollConnection),
        topBar = {
            LargeTopAppBar(
                colors = TopAppBarDefaults.topAppBarColors(
                    containerColor = MaterialTheme.colorScheme.primaryContainer,
                    titleContentColor = MaterialTheme.colorScheme.primary,
                ),
                title = {
                    Text(
                        "Large Top App Bar",
                        maxLines = 1,
                        overflow = TextOverflow.Ellipsis
                    )
                },
                navigationIcon = {
                    IconButton(onClick = { /* do something */ }) {
                        Icon(
                            imageVector = Icons.AutoMirrored.Filled.ArrowBack,
                            contentDescription = "Localized description"
                        )
                    }
                },
                actions = {
                    IconButton(onClick = { /* do something */ }) {
                        Icon(
                            imageVector = Icons.Filled.Menu,
                            contentDescription = "Localized description"
                        )
                    }
                },
                scrollBehavior = scrollBehavior
            )
        },
    ) { innerPadding ->
        ScrollContent(innerPadding)
    }
}

此实现如下所示:

应用中的界面,底部应用栏位于左侧,用于放置操作图标,右侧则有一个悬浮操作按钮。
图 5. 大型顶部应用栏的实现示例。

底部应用栏

如需创建底部应用栏,请使用 BottomAppBar 可组合项。使用此可组合项与本页前面部分中介绍的顶部应用栏可组合项非常相似。您可以为以下关键参数传递可组合项:

  • actions:栏左侧显示的一系列图标。这些通常是给定屏幕的关键操作或导航项。
  • floatingActionButton:显示在栏右侧的悬浮操作按钮。

@Composable
fun BottomAppBarExample() {
    Scaffold(
        bottomBar = {
            BottomAppBar(
                actions = {
                    IconButton(onClick = { /* do something */ }) {
                        Icon(Icons.Filled.Check, contentDescription = "Localized description")
                    }
                    IconButton(onClick = { /* do something */ }) {
                        Icon(
                            Icons.Filled.Edit,
                            contentDescription = "Localized description",
                        )
                    }
                    IconButton(onClick = { /* do something */ }) {
                        Icon(
                            Icons.Filled.Mic,
                            contentDescription = "Localized description",
                        )
                    }
                    IconButton(onClick = { /* do something */ }) {
                        Icon(
                            Icons.Filled.Image,
                            contentDescription = "Localized description",
                        )
                    }
                },
                floatingActionButton = {
                    FloatingActionButton(
                        onClick = { /* do something */ },
                        containerColor = BottomAppBarDefaults.bottomAppBarFabColor,
                        elevation = FloatingActionButtonDefaults.bottomAppBarFabElevation()
                    ) {
                        Icon(Icons.Filled.Add, "Localized description")
                    }
                }
            )
        },
    ) { innerPadding ->
        Text(
            modifier = Modifier.padding(innerPadding),
            text = "Example of a scaffold with a bottom app bar."
        )
    }
}

此实现如下所示:

应用中的界面,底部应用栏中包含左侧的操作图标和右侧的悬浮操作按钮。
图 6. 底部应用栏的实现示例。

其他资源