I gruppi di pulsanti organizzano i pulsanti e aggiungono interazioni tra loro applicando modifiche coordinate di forma, movimento e larghezza ai pulsanti e ai pulsanti con icona. Esistono due varianti di gruppi di pulsanti:
- Gruppo di pulsanti standard: aggiunge l'interazione tra pulsanti adiacenti in modo che rispondano l'uno all'altro quando vengono premuti.
- Gruppo di pulsanti collegati: raggruppa i pulsanti di attivazione/disattivazione per consentire agli utenti di selezionare opzioni, cambiare visualizzazione o ordinare gli elementi di una pagina.
Utilizzo dei gruppi di pulsanti
- Applica la metamorfosi delle forme quando i pulsanti vengono premuti o selezionati.
- I gruppi di pulsanti collegati sostituiscono i pulsanti segmentati.
- Funziona con tutte le dimensioni dei pulsanti: XS, S, M, L e XL.
- Supporta i pattern di selezione singola, selezione multipla e selezione obbligatoria.
Gruppo di pulsanti standard
Utilizza il componibile ButtonGroup per posizionare i pulsanti in una sequenza orizzontale che espande l'elemento premuto, comprime gli elementi adiacenti e sposta gli elementi aggiuntivi in un menu extra quando lo spazio è limitato. I gruppi di pulsanti devono rimanere su una singola riga anziché andare a capo su una seconda riga.
Il seguente snippet mostra come implementare un gruppo di pulsanti standard con un indicatore di menu extra:
@Composable fun ButtonGroupSample() { val numButtons = 10 ButtonGroup( overflowIndicator = { menuState -> ButtonGroupDefaults.OverflowIndicator(menuState = menuState) } ) { for (i in 0 until numButtons) { clickableItem(onClick = {}, label = "$i") } } }
Gruppo di pulsanti collegati
Utilizza i gruppi di pulsanti collegati per i pattern di selezione singola o multipla creati con gli elementi componibili ToggleButton e le forme collegate ButtonGroupDefaults.
Selezione singola
Utilizza un gruppo di pulsanti collegati a selezione singola quando l'utente sceglie un'opzione da un insieme di opzioni che si escludono a vicenda. Lo snippet seguente implementa un gruppo di pulsanti connessi a selezione singola utilizzando ToggleButton e Role.RadioButton:
@Composable fun SingleSelectConnectedButtonGroupSample() { val options = listOf("Work", "Restaurant", "Coffee", "Search", "Home") val unCheckedIcons = listOf( AppIcons.Work, AppIcons.Restaurant, AppIcons.Coffee, AppIcons.Search, AppIcons.Home, ) val checkedIcons = listOf( AppIcons.WorkFilled, AppIcons.Restaurant, AppIcons.CoffeeFilled, AppIcons.Search, AppIcons.HomeFilled, ) var selectedIndex by remember { mutableIntStateOf(0) } FlexBox( modifier = Modifier.padding(horizontal = 8.dp).fillMaxWidth(), config = { direction(FlexDirection.Row) wrap(FlexWrap.Wrap) columnGap(ButtonGroupDefaults.ConnectedSpaceBetween) rowGap(2.dp) }, ) { options.forEachIndexed { index, label -> ToggleButton( checked = selectedIndex == index, onCheckedChange = { selectedIndex = index }, shapes = when (index) { 0 -> ButtonGroupDefaults.connectedLeadingButtonShapes() options.lastIndex -> ButtonGroupDefaults.connectedTrailingButtonShapes() else -> ButtonGroupDefaults.connectedMiddleButtonShapes() }, modifier = Modifier.semantics { role = Role.RadioButton }, ) { Icon( painter = rememberVectorPainter( if (selectedIndex == index) checkedIcons[index] else unCheckedIcons[index] ), contentDescription = null, ) Spacer(Modifier.size(ToggleButtonDefaults.IconSpacing)) Text(label) } } } }
Selezione multipla
Utilizza un gruppo di pulsanti collegati a selezione multipla quando l'utente può attivare o disattivare zero o più opzioni in modo indipendente. Il seguente snippet implementa un gruppo di pulsanti collegati a selezione multipla utilizzando ToggleButton e mutableStateListOf:
@Composable fun MultiSelectConnectedButtonGroupSample() { val options = listOf("Work", "Restaurant", "Coffee", "Search", "Home") val unCheckedIcons = listOf( AppIcons.Work, AppIcons.Restaurant, AppIcons.Coffee, AppIcons.Search, AppIcons.Home, ) val checkedIcons = listOf( AppIcons.WorkFilled, AppIcons.Restaurant, AppIcons.CoffeeFilled, AppIcons.Search, AppIcons.HomeFilled, ) val checked = remember { mutableStateListOf(false, false, false, false, false) } FlexBox( modifier = Modifier.padding(horizontal = 8.dp).fillMaxWidth(), config = { direction(FlexDirection.Row) wrap(FlexWrap.Wrap) columnGap(ButtonGroupDefaults.ConnectedSpaceBetween) rowGap(2.dp) }, ) { options.forEachIndexed { index, label -> ToggleButton( checked = checked[index], onCheckedChange = { checked[index] = it }, shapes = when (index) { 0 -> ButtonGroupDefaults.connectedLeadingButtonShapes() options.lastIndex -> ButtonGroupDefaults.connectedTrailingButtonShapes() else -> ButtonGroupDefaults.connectedMiddleButtonShapes() }, ) { Icon( painter = rememberVectorPainter( if (checked[index]) checkedIcons[index] else unCheckedIcons[index] ), contentDescription = null, ) Spacer(Modifier.size(ToggleButtonDefaults.IconSpacing)) Text(label) } } } }