拆分按钮定义了一个双按钮组,其中前导按钮执行主要操作,尾随按钮打开一组与上下文相关的次要选项。
激活后,尾部菜单按钮会旋转其图标并改变形状。 拆分按钮可以单独放置,也可以与其他大小相同的按钮并排放置。
使用拆分按钮
- 打开一个菜单,为用户提供与主要操作相关的次要选项。
- 可单独使用,也可与标准按钮和图标按钮搭配使用。
- 通常会打开一个菜单,但也可以自定义为打开其他组件(例如卡片)。
- 支持与按钮和图标按钮相同的五种尺寸:超小 (XS)、小 (S)、中 (M)、大 (L) 和超大 (XL)。
示例
实心拆分按钮
填充式拆分按钮是高强调变体,用于重要或最终操作。以下代码段使用 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, ) } }, ) }