Pulsante Suddividi

Un pulsante di suddivisione definisce un gruppo di due pulsanti in cui il pulsante principale esegue un'azione principale e il pulsante finale apre un insieme secondario di opzioni correlate al contesto.

Quando viene attivato, il pulsante del menu finale ruota l'icona e cambia forma. I pulsanti di tipo split possono essere posizionati da soli o accanto ad altri pulsanti della stessa dimensione.

Utilizzo dei pulsanti di suddivisione

  • Apre un menu per offrire agli utenti opzioni secondarie relative all'azione principale.
  • Funziona da solo o insieme ai pulsanti standard e ai pulsanti con icona.
  • In genere apre un menu, ma può essere personalizzato per aprire altri componenti, come le schede.
  • Supporta le stesse cinque dimensioni dei pulsanti e dei pulsanti con icona: extra small (XS), small (S), medium (M), large (L) ed extra large (XL).
Pulsanti di suddivisione in più dimensioni e stili di colore.
Figura 1. Pulsanti divisi in più dimensioni e stili di colore.

Esempi

Pulsante di opzione pieno

Un pulsante diviso con riempimento è la variante con enfasi elevata utilizzata per azioni importanti o finali. Il seguente snippet implementa un pulsante di tipo split pieno utilizzando SplitButtonLayout con SplitButtonDefaults.LeadingButton e SplitButtonDefaults.TrailingButton:

@Composable
fun FilledSplitButtonSample() {
    var checked by rememberSaveable { mutableStateOf(false) }

    SplitButtonLayout(
        leadingButton = {
            SplitButtonDefaults.LeadingButton(onClick = { /* Do Nothing */ }) {
                Icon(
                    painter = rememberVectorPainter(AppIcons.Edit),
                    modifier = Modifier.size(SplitButtonDefaults.LeadingIconSize),
                    contentDescription = null,
                )
                Spacer(Modifier.size(ButtonDefaults.IconSpacing))
                Text("My Button")
            }
        },
        trailingButton = {
            SplitButtonDefaults.TrailingButton(
                checked = checked,
                onCheckedChange = { checked = it },
                modifier =
                    Modifier.semantics {
                        stateDescription = if (checked) "Expanded" else "Collapsed"
                        contentDescription = "Toggle Button"
                    },
            ) {
                val rotation: Float by
                    animateFloatAsState(
                        targetValue = if (checked) 180f else 0f,
                        label = "Trailing Icon Rotation",
                    )
                Icon(
                    painter = rememberVectorPainter(AppIcons.KeyboardArrowDown),
                    modifier =
                        Modifier.size(SplitButtonDefaults.TrailingIconSize).graphicsLayer {
                            this.rotationZ = rotation
                        },
                    contentDescription = null,
                )
            }
        },
    )
}

Pulsante di suddivisione tonale

Un pulsante di suddivisione tonale è la variante con enfasi media di un pulsante di suddivisione. Lo snippet seguente utilizza SplitButtonDefaults.TonalLeadingButton e SplitButtonDefaults.TonalTrailingButton all'interno di SplitButtonLayout:

@Composable
fun TonalSplitButtonSample() {
    var checked by rememberSaveable { mutableStateOf(false) }

    SplitButtonLayout(
        leadingButton = {
            SplitButtonDefaults.TonalLeadingButton(onClick = { /* Do Nothing */ }) {
                Icon(
                    painter = rememberVectorPainter(AppIcons.Edit),
                    modifier = Modifier.size(SplitButtonDefaults.LeadingIconSize),
                    contentDescription = null,
                )
                Spacer(Modifier.size(ButtonDefaults.IconSpacing))
                Text("My Button")
            }
        },
        trailingButton = {
            SplitButtonDefaults.TonalTrailingButton(
                checked = checked,
                onCheckedChange = { checked = it },
                modifier =
                    Modifier.semantics {
                        stateDescription = if (checked) "Expanded" else "Collapsed"
                        contentDescription = "Toggle Button"
                    },
            ) {
                val rotation: Float by
                    animateFloatAsState(
                        targetValue = if (checked) 180f else 0f,
                        label = "Trailing Icon Rotation",
                    )
                Icon(
                    painter = rememberVectorPainter(AppIcons.KeyboardArrowDown),
                    modifier =
                        Modifier.size(SplitButtonDefaults.TrailingIconSize).graphicsLayer {
                            this.rotationZ = rotation
                        },
                    contentDescription = null,
                )
            }
        },
    )
}