Botão de divisão

Um botão de divisão define um grupo de dois botões em que o botão principal executa uma ação principal e o botão secundário abre um conjunto secundário de opções relacionadas ao contexto.

Quando ativado, o botão de menu final gira o ícone e muda de forma. Os botões divididos podem ser colocados sozinhos ou ao lado de outros botões do mesmo tamanho.

Como usar botões de divisão

  • Abre um menu para oferecer aos usuários opções secundárias relacionadas à ação principal.
  • Funciona sozinho ou com botões padrão e de ícone.
  • Normalmente, abre um menu, mas pode ser personalizado para abrir outros componentes, como cards.
  • Oferece suporte aos mesmos cinco tamanhos dos botões e botões de ícone: extra pequeno (XS), pequeno (S), médio (M), grande (L) e extra grande (XL).
Botões de divisão em vários tamanhos e estilos de cores.
Figura 1. Botões de divisão em vários tamanhos e estilos de cores.

Exemplos

Botão de divisão preenchido

Um botão de divisão preenchido é a variante de alta ênfase usada para ações importantes ou finais. O snippet a seguir implementa um botão de divisão preenchido usando SplitButtonLayout com 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,
                )
            }
        },
    )
}

Botão de divisão tonal

Um botão de divisão tonal é a variante de prioridade média de um botão de divisão. O snippet a seguir usa SplitButtonDefaults.TonalLeadingButton e 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,
                )
            }
        },
    )
}