Przycisk podziału

Przycisk dzielony definiuje grupę 2 przycisków, w której przycisk wiodący wykonuje działanie główne, a przycisk końcowy otwiera dodatkowy zestaw opcji powiązanych kontekstowo.

Po aktywacji przycisk menu na końcu zmienia kształt i obraca ikonę. Przyciski dzielone można umieszczać samodzielnie lub obok innych przycisków o tym samym rozmiarze.

Korzystanie z przycisków dzielonych

  • Otwiera menu z dodatkowymi opcjami związanymi z głównym działaniem.
  • Działa samodzielnie lub razem ze standardowymi przyciskami i przyciskami z ikonami.
  • Zwykle otwiera menu, ale można go dostosować, aby otwierał inne komponenty, takie jak karty.
  • Obsługuje te same 5 rozmiarów co przyciski i przyciski ikon: bardzo mały (XS), mały (S), średni (M), duży (L) i bardzo duży (XL).
Przyciski dzielone w różnych rozmiarach i stylach kolorystycznych.
Rysunek 1. Przyciski dzielone w różnych rozmiarach i kolorach.

Przykłady

Wypełniony przycisk dzielony

Wypełniony przycisk dzielony to wariant o wysokim kontraście, który jest używany do ważnych lub ostatecznych działań. Poniższy fragment kodu implementuje wypełniony przycisk dzielony za pomocą funkcji SplitButtonLayout z parametrami SplitButtonDefaults.LeadingButton i 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,
                )
            }
        },
    )
}

Przycisk podziału tonalnego

Przycisk podziału z kolorem tonalnym to wariant przycisku podziału o średnim poziomie wyróżnienia. Ten fragment kodu używa SplitButtonDefaults.TonalLeadingButton i SplitButtonDefaults.TonalTrailingButton w 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,
                )
            }
        },
    )
}