Menú del botón de acción flotante (BAF)

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.
Tres conjuntos de colores para el menú de BAF: primario, secundario y terciario.
Figura 1: Conjuntos de colores del menú del BAF: primario, secundario y terciario.

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) },
                )
            }
        }
    }
}