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