Menu du bouton d'action flottant

Un menu de bouton d'action flottant s'ouvre à partir d'un bouton d'action flottant pour afficher plusieurs actions associées dans Material 3.

Cela permet de garder les actions clés accessibles tout en conservant une UI épurée en masquant les actions secondaires lorsqu'elles ne sont pas nécessaires, en remplaçant les numérotations abrégées et les petits FAB empilés.

Utiliser le menu FAB

  • S'ouvre à partir d'un bouton d'action flottant pour afficher deux à six actions associées flottant à l'écran.
  • Utilise une seule taille de menu FAB pour toutes les tailles de FAB.
  • Non utilisé avec les boutons d'action flottants étendus.
  • Compatible avec les ensembles de couleurs primaires, secondaires et tertiaires.
Trois ensembles de couleurs pour le menu du bouton d'action flottant : primaire, secondaire et tertiaire.
Figure 1. Ensembles de couleurs du menu du bouton d'action flottant : primaire, secondaire et tertiaire.

Exemples

Exemple de menu FAB

Associez FloatingActionButtonMenu à ToggleFloatingActionButton pour développer et réduire une liste d'actions FloatingActionButtonMenuItem. L'extrait suivant masque le bouton d'action flottant d'activation/désactivation lorsque vous faites défiler une liste vers le bas et développe le menu lorsque vous appuyez dessus :

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