Un menú de botón de acción flotante (BAF) se abre desde un BAF para mostrar varias acciones relacionadas en Material 3.
Esto mantiene accesibles las acciones clave y, al mismo tiempo, mantiene limpia la IU, ya que oculta las acciones secundarias cuando no son necesarias, lo que reemplaza los botones de marcado rápido y los FAB pequeños apilados.
Cómo usar el menú del FAB
- Se abre desde un BAF para mostrar de dos a seis acciones relacionadas que flotan en la pantalla.
- Usa un tamaño de menú de FAB en todos los tamaños de FAB.
- No se usa con BAF extendidos.
- Admite conjuntos de colores primarios, secundarios y terciarios.
Ejemplos
Ejemplo de menú de FAB
Vincula FloatingActionButtonMenu con ToggleFloatingActionButton para expandir y contraer una lista de acciones de FloatingActionButtonMenuItem. En el siguiente fragmento, se oculta el FAB de activación cuando se desplaza hacia abajo en una lista y se expande el menú cuando se presiona:
@Composable fun FloatingActionButtonMenuSample() { val listState = rememberLazyListState() val fabVisible by remember { derivedStateOf { listState.firstVisibleItemIndex == 0 } } Box { LazyColumn(state = listState, modifier = Modifier.fillMaxSize()) { for (index in 0 until 100) { item { Text(text = "List item - $index", modifier = Modifier.padding(24.dp)) } } } val items = listOf( AppIcons.Message to "Reply", AppIcons.People to "Reply all", AppIcons.Contacts to "Forward", AppIcons.Snooze to "Snooze", AppIcons.Archive to "Archive", AppIcons.Label to "Label", ) var fabMenuExpanded by rememberSaveable { mutableStateOf(false) } FloatingActionButtonMenu( modifier = Modifier.align(Alignment.BottomEnd), expanded = fabMenuExpanded, button = { ToggleFloatingActionButton( modifier = Modifier.semantics { traversalIndex = -1f stateDescription = if (fabMenuExpanded) "Expanded" else "Collapsed" contentDescription = "Toggle menu" } .animateFloatingActionButton( visible = fabVisible || fabMenuExpanded, alignment = Alignment.BottomEnd, ), checked = fabMenuExpanded, onCheckedChange = { fabMenuExpanded = !fabMenuExpanded }, ) { val imageVector by remember { derivedStateOf { if (checkedProgress > 0.5f) AppIcons.Close else AppIcons.Add } } Icon( painter = rememberVectorPainter(imageVector), contentDescription = null, modifier = Modifier.animateIcon({ checkedProgress }), ) } }, ) { items.forEach { item -> FloatingActionButtonMenuItem( onClick = { fabMenuExpanded = false }, icon = { Icon(painter = rememberVectorPainter(item.first), contentDescription = null) }, text = { Text(text = item.second) }, ) } } } }