悬浮操作按钮 (FAB) 是一种高强调度按钮,可让用户在应用中执行主要操作。它可促进用户采取单一、集中的操作,这是用户最可能采取的路径,通常固定在屏幕右下角。
请考虑以下三种可能使用 FAB 的应用场景:
- 创建新内容:在记事应用中,FAB 可用于快速创建新记事。
- 添加新联系人:在聊天应用中,FAB 可以打开一个界面,让用户将某人添加到对话中。
- 居中显示位置:在地图界面中,FAB 可以将地图居中显示在用户的当前位置。
在 Material Design 中,FAB 有四种类型:
- FAB:普通大小的悬浮操作按钮。
- 小型 FAB:较小的悬浮操作按钮。
- 大型 FAB:较大的悬浮操作按钮。
- 扩展型 FAB:不仅包含图标的悬浮操作按钮。
API Surface
虽然您可以使用多个可组合项来创建符合 Material Design 的悬浮操作按钮,但它们的参数并无太大差异。您应注意的关键参数包括:
onClick:用户按下按钮时调用的函数。containerColor:按钮的颜色。contentColor:图标的颜色。
悬浮操作按钮
如需创建常规悬浮操作按钮,请使用基本 FloatingActionButton 可组合项。以下示例演示了 FAB 的基本实现:
@Composable fun Example(onClick: () -> Unit) { FloatingActionButton( onClick = { onClick() }, ) { Icon(painter = rememberVectorPainter(AppIcons.Add), "Floating action button.") } }
此实现如下所示:
小按钮
如需创建小型悬浮操作按钮,请使用 SmallFloatingActionButton 可组合项。以下示例演示了如何执行此操作,并添加了自定义颜色。
@Composable fun SmallExample(onClick: () -> Unit) { SmallFloatingActionButton( onClick = { onClick() }, containerColor = MaterialTheme.colorScheme.secondaryContainer, contentColor = MaterialTheme.colorScheme.secondary ) { Icon(painter = rememberVectorPainter(AppIcons.Add), "Small floating action button.") } }
此实现如下所示:
大按钮
如需创建大型悬浮操作按钮,请使用 LargeFloatingActionButton 可组合项。除了会生成更大的按钮之外,此可组合项与其他示例没有显著差异。
以下是大型 FAB 的简单实现。
@Composable fun LargeExample(onClick: () -> Unit) { LargeFloatingActionButton( onClick = { onClick() }, shape = CircleShape, ) { Icon(painter = rememberVectorPainter(AppIcons.Add), "Large floating action button") } }
此实现如下所示:
扩展按钮
您可以使用 ExtendedFloatingActionButton 可组合项创建更复杂的悬浮操作按钮。它与 FloatingActionButton 的主要区别在于,它具有专用的 icon 和 text 参数。借助这些组件,您可以创建包含更复杂内容的按钮,这些内容会适当缩放以适应其内容。
以下代码段演示了如何实现 ExtendedFloatingActionButton,并为 icon 和 text 传递了示例值。
@Composable fun ExtendedExample(onClick: () -> Unit) { ExtendedFloatingActionButton( onClick = { onClick() }, icon = { Icon(painter = rememberVectorPainter(AppIcons.Edit), "Extended floating action button.") }, text = { Text(text = "Extended FAB") }, ) }
此实现如下所示:
M3 Expressive 更新
FAB 提供了更多尺寸,以匹配扩展型 FAB 和扩展的颜色选项,其中包括 MediumFloatingActionButton,建议在大多数情况下与现有 FAB 尺寸搭配使用。
如需详细了解悬浮操作按钮的 M3 Expressive 更新,请参阅 Material Design 3 悬浮操作按钮指南。
中型悬浮操作按钮
建议在大多数情况下使用中型 FAB,它在紧凑型和中等窗口中效果最佳。可用于重要操作,且不会占用太多空间。
以下代码段演示了如何使用 MediumFloatingActionButton 实现中型悬浮操作按钮:
@Composable fun MediumFloatingActionButtonSample() { MediumFloatingActionButton(onClick = {}) { Icon( painter = rememberVectorPainter(AppIcons.Add), contentDescription = "Add", modifier = Modifier.size(FloatingActionButtonDefaults.MediumIconSize), ) } }