Gruppi di pulsanti

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:

  1. Gruppo di pulsanti standard: aggiunge l'interazione tra pulsanti adiacenti in modo che rispondano l'uno all'altro quando vengono premuti.
  2. 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.
Gruppi di pulsanti standard a sinistra e gruppi di pulsanti collegati a destra.
Figura 1. Gruppi di pulsanti standard (1, a sinistra) e gruppi di pulsanti collegati (2, a destra).

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.
Gruppi di pulsanti contenenti pulsanti di varie forme e dimensioni.
Figura 2. Gruppi di pulsanti di varie forme e dimensioni.

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.

Comportamento del gruppo di pulsanti connessi.
Figura 3. Comportamento del gruppo di pulsanti connessi adattabili.

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