Кнопка разделения

Разделенная кнопка – это группа из двух кнопок, первая из которых выполняет основное действие, а вторая открывает набор дополнительных вариантов, связанных с контекстом.

При активации значок кнопки меню в конце поворачивается и меняет форму. Кнопки с разделением можно размещать отдельно или рядом с другими кнопками того же размера.

Как использовать разделенные кнопки

  • Открывает меню с дополнительными действиями, связанными с основным.
  • Работает отдельно или вместе со стандартными кнопками и кнопками со значками.
  • Обычно открывает меню, но может быть настроен для открытия других компонентов, таких как карточки.
  • Поддерживает те же пять размеров, что и кнопки и кнопки со значками: очень маленький (XS), маленький (S), средний (M), большой (L) и очень большой (XL).
Разделенные кнопки разных размеров и цветов.
Рисунок 1. Разделенные кнопки разных размеров и цветов.

Примеры

Заполненная разделенная кнопка

Заполненная разделенная кнопка – это вариант с высоким акцентом, который используется для важных или окончательных действий. В следующем фрагменте кода показано, как реализовать заполненную разделенную кнопку с помощью SplitButtonLayout с SplitButtonDefaults.LeadingButton и 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,
                )
            }
        },
    )
}

Тональная разделенная кнопка

Тональная разделенная кнопка – это вариант разделенной кнопки со средним акцентом. В следующем фрагменте кода используются свойства SplitButtonDefaults.TonalLeadingButton и SplitButtonDefaults.TonalTrailingButton внутри 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,
                )
            }
        },
    )
}