拆分按钮

拆分按钮定义了一个双按钮组,其中前导按钮执行主要操作,尾随按钮打开一组与上下文相关的次要选项。

激活后,尾部菜单按钮会旋转其图标并改变形状。 拆分按钮可以单独放置,也可以与其他大小相同的按钮并排放置。

使用拆分按钮

  • 打开一个菜单,为用户提供与主要操作相关的次要选项。
  • 可单独使用,也可与标准按钮和图标按钮搭配使用。
  • 通常会打开一个菜单,但也可以自定义为打开其他组件(例如卡片)。
  • 支持与按钮和图标按钮相同的五种尺寸:超小 (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,
                )
            }
        },
    )
}

色调拆分按钮

色调拆分按钮是中度强调的拆分按钮变体。以下代码段在 SplitButtonLayout 中使用 SplitButtonDefaults.TonalLeadingButton 和 SplitButtonDefaults.TonalTrailingButton:

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