悬浮工具栏

浮动工具栏会悬浮在正文内容上方。最适合用于与正文内容或特定页面相关的关联操作。

您可以将悬浮工具栏放置在屏幕上的任意位置,使其悬浮在其他内容之上,从而提供灵活的放置位置和空间,以便执行多项操作。

使用浮动工具栏

  • 浮动工具栏会显示与当前页面相关的控件。
  • 浮动工具栏可用作产品层次结构中相关页面之间的导航控件。
  • 如果需要更多操作,请使用溢出菜单。
  • 浮动工具栏的容器应在屏幕上保持完全可见。
  • 选择默认在屏幕上显示的最重要的操作。

布局和颜色

浮动工具栏可以是水平 (HorizontalFloatingToolbar) 或垂直 (VerticalFloatingToolbar) 的,并且可以使用 FloatingToolbarDefaults 中的标准或鲜艳配色方案。

浅色主题水平浮动工具栏  浅色主题垂直浮动工具栏 
图 1. 水平和垂直浮动工具栏。

带有 FAB 的浮动工具栏

使用随附的悬浮操作按钮 (FAB) 执行视图中优先级最高的操作,或对工具栏的控件进行补充。

浅色主题水平浮动工具栏(带 FAB)  浅色主题垂直浮动工具栏(带 FAB) 
图 2. 带有 FAB 的浮动工具栏。

示例

可展开的水平悬浮工具栏

将 Modifier.floatingToolbarVerticalNestedScroll 应用于可滚动容器,以便 HorizontalFloatingToolbar 在用户向下滚动时自动收起其前导和尾随操作,并在向上滚动时展开:

@Composable
fun ExpandableHorizontalFloatingToolbarSample() {
    var expanded by rememberSaveable { mutableStateOf(true) }
    Scaffold { innerPadding ->
        Box(Modifier.padding(innerPadding)) {
            HorizontalFloatingToolbar(
                modifier =
                    Modifier.align(Alignment.BottomCenter)
                        .offset(y = -FloatingToolbarDefaults.ScreenOffset)
                        .zIndex(1f),
                expanded = expanded,
                leadingContent = {
                    IconButton(onClick = { /* doSomething() */ }) {
                        Icon(painter = rememberVectorPainter(AppIcons.Edit), contentDescription = "Edit")
                    }
                    IconButton(onClick = { /* doSomething() */ }) {
                        Icon(painter = rememberVectorPainter(AppIcons.Favorite), contentDescription = "Favorite")
                    }
                },
                trailingContent = {
                    IconButton(onClick = { /* doSomething() */ }) {
                        Icon(painter = rememberVectorPainter(AppIcons.Share), contentDescription = "Share")
                    }
                },
                content = {
                    FilledIconButton(
                        modifier = Modifier.width(64.dp),
                        onClick = { /* doSomething() */ },
                    ) {
                        Icon(painter = rememberVectorPainter(AppIcons.Add), contentDescription = "Add")
                    }
                },
            )
            // ...
        }
    }
}

可展开的垂直浮动工具栏

当垂直布局空间适合您的屏幕层次结构时,请使用锚定到屏幕一侧的 VerticalFloatingToolbar。与横向变体一样,它可以根据滚动动作展开和收起:

@Composable
fun ExpandableVerticalFloatingToolbarSample() {
    var expanded by rememberSaveable { mutableStateOf(true) }
    Scaffold { innerPadding ->
        Box(Modifier.padding(innerPadding)) {
            VerticalFloatingToolbar(
                modifier =
                    Modifier.align(Alignment.CenterEnd)
                        .offset(x = -FloatingToolbarDefaults.ScreenOffset)
                        .zIndex(1f),
                expanded = expanded,
                leadingContent = {
                    IconButton(onClick = { /* doSomething() */ }) {
                        Icon(painter = rememberVectorPainter(AppIcons.Edit), contentDescription = "Edit")
                    }
                    IconButton(onClick = { /* doSomething() */ }) {
                        Icon(painter = rememberVectorPainter(AppIcons.Favorite), contentDescription = "Favorite")
                    }
                },
                trailingContent = {
                    IconButton(onClick = { /* doSomething() */ }) {
                        Icon(painter = rememberVectorPainter(AppIcons.Share), contentDescription = "Share")
                    }
                },
                content = {
                    FilledIconButton(
                        modifier = Modifier.height(64.dp),
                        onClick = { /* doSomething() */ },
                    ) {
                        Icon(painter = rememberVectorPainter(AppIcons.Add), contentDescription = "Add")
                    }
                },
            )
            // ...
        }
    }
}

可滚动的悬浮工具栏

如需在滚动时将整个悬浮工具栏滑出屏幕,而不是收起其内容,请将 FloatingToolbarDefaults.exitAlwaysScrollBehavior 传递给 Modifier.nestedScroll 和工具栏的 scrollBehavior 参数:

@Composable
fun ScrollableHorizontalFloatingToolbarSample() {
    val exitAlwaysScrollBehavior =
        FloatingToolbarDefaults.exitAlwaysScrollBehavior(
            exitDirection = FloatingToolbarExitDirection.Bottom
        )
    Scaffold(modifier = Modifier.nestedScroll(exitAlwaysScrollBehavior)) { innerPadding ->
        Box(Modifier.padding(innerPadding)) {
            HorizontalFloatingToolbar(
                modifier =
                    Modifier.align(Alignment.BottomCenter)
                        .offset(y = -FloatingToolbarDefaults.ScreenOffset)
                        .zIndex(1f),
                expanded = true,
                leadingContent = {
                    IconButton(onClick = { /* doSomething() */ }) {
                        Icon(painter = rememberVectorPainter(AppIcons.Edit), contentDescription = "Edit")
                    }
                    IconButton(onClick = { /* doSomething() */ }) {
                        Icon(painter = rememberVectorPainter(AppIcons.Favorite), contentDescription = "Favorite")
                    }
                },
                trailingContent = {
                    IconButton(onClick = { /* doSomething() */ }) {
                        Icon(painter = rememberVectorPainter(AppIcons.Share), contentDescription = "Share")
                    }
                },
                content = {
                    FilledIconButton(
                        modifier = Modifier.width(64.dp),
                        onClick = { /* doSomething() */ },
                    ) {
                        Icon(painter = rememberVectorPainter(AppIcons.Add), contentDescription = "Add")
                    }
                },
                scrollBehavior = exitAlwaysScrollBehavior,
            )
            // ...
        }
    }
}