Un botón de división define un grupo de dos botones en el que el botón principal realiza una acción principal y el botón secundario abre un conjunto secundario de opciones relacionadas contextualmente.
Cuando se activa, el botón de menú final rota su ícono y cambia de forma. Los botones divididos se pueden colocar solos o junto a otros botones del mismo tamaño.
Uso de botones divididos
- Abre un menú para brindarles a los usuarios opciones secundarias relacionadas con la acción principal.
- Funciona solo o junto con botones estándar y botones de íconos.
- Por lo general, abre un menú, pero se puede personalizar para abrir otros componentes, como tarjetas.
- Admite los mismos cinco tamaños que los botones y los botones de ícono: extrapequeño (XS), pequeño (S), mediano (M), grande (L) y extragrande (XL).
Ejemplos
Botón de división relleno
Un botón de selección múltiple relleno es la variante de alto énfasis que se usa para acciones importantes o finales. En el siguiente fragmento, se implementa un botón de división relleno con SplitButtonLayout con SplitButtonDefaults.LeadingButton y 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, ) } }, ) }
Botón de división tonal
Un botón de división tonal es la variante de énfasis medio de un botón de división. En el siguiente fragmento, se usan SplitButtonDefaults.TonalLeadingButton y SplitButtonDefaults.TonalTrailingButton dentro de 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, ) } }, ) }