Botón Dividir

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).
Botones divididos en varios tamaños y estilos de color.
Figura 1: Botones divididos en varios tamaños y estilos de color.

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