Los grupos de botones organizan los botones y agregan interacciones entre ellos aplicando cambios coordinados de forma, movimiento y ancho a los botones y los botones de ícono. Existen dos variantes de grupos de botones:
- Grupo de botones estándar: Agrega interacción entre botones adyacentes para que respondan entre sí cuando se presionan.
- Grupo de botones conectados: Agrupa botones de activación para que los usuarios seleccionen opciones, cambien de vista o clasifiquen elementos en una página.
Usa grupos de botones
- Aplica la transformación de formas cuando se presionan o seleccionan los botones.
- Los grupos de botones conectados reemplazan a los botones segmentados.
- Funciona con todos los tamaños de botones: extrapequeño (XS), pequeño (S), mediano (M), grande (L) y extragrande (XL).
- Admite patrones de selección única, selección múltiple y selección obligatoria.
Grupo de botones estándar
Usa el elemento componible ButtonGroup para colocar botones en una secuencia horizontal que expanda el elemento presionado, comprima los elementos vecinos y mueva los elementos adicionales a un menú ampliado cuando el espacio sea limitado. Los grupos de botones deben permanecer en
una sola línea en lugar de ajustarse a una segunda línea.
En el siguiente fragmento, se muestra cómo implementar un grupo de botones estándar con un indicador de menú ampliado:
@Composable fun ButtonGroupSample() { val numButtons = 10 ButtonGroup( overflowIndicator = { menuState -> ButtonGroupDefaults.OverflowIndicator(menuState = menuState) } ) { for (i in 0 until numButtons) { clickableItem(onClick = {}, label = "$i") } } }
Grupo de botones conectados
Usa grupos de botones conectados para patrones de selección única o múltiple creados con elementos componibles ToggleButton y formas conectadas ButtonGroupDefaults.
Selección única
Usa un grupo de botones conectados de selección única cuando el usuario elija una opción de un conjunto mutuamente excluyente. En el siguiente fragmento, se implementa un grupo de botones conectados de selección única con ToggleButton y Role.RadioButton:
@Composable fun SingleSelectConnectedButtonGroupSample() { val options = listOf("Work", "Restaurant", "Coffee", "Search", "Home") val unCheckedIcons = listOf( AppIcons.Work, AppIcons.Restaurant, AppIcons.Coffee, AppIcons.Search, AppIcons.Home, ) val checkedIcons = listOf( AppIcons.WorkFilled, AppIcons.Restaurant, AppIcons.CoffeeFilled, AppIcons.Search, AppIcons.HomeFilled, ) var selectedIndex by remember { mutableIntStateOf(0) } FlexBox( modifier = Modifier.padding(horizontal = 8.dp).fillMaxWidth(), config = { direction(FlexDirection.Row) wrap(FlexWrap.Wrap) columnGap(ButtonGroupDefaults.ConnectedSpaceBetween) rowGap(2.dp) }, ) { options.forEachIndexed { index, label -> ToggleButton( checked = selectedIndex == index, onCheckedChange = { selectedIndex = index }, shapes = when (index) { 0 -> ButtonGroupDefaults.connectedLeadingButtonShapes() options.lastIndex -> ButtonGroupDefaults.connectedTrailingButtonShapes() else -> ButtonGroupDefaults.connectedMiddleButtonShapes() }, modifier = Modifier.semantics { role = Role.RadioButton }, ) { Icon( painter = rememberVectorPainter( if (selectedIndex == index) checkedIcons[index] else unCheckedIcons[index] ), contentDescription = null, ) Spacer(Modifier.size(ToggleButtonDefaults.IconSpacing)) Text(label) } } } }
Selector múltiple
Usa un grupo de botones conectados de selección múltiple cuando el usuario pueda activar o desactivar cero o más opciones de forma independiente. En el siguiente fragmento, se implementa un grupo de botones conectados de selección múltiple con ToggleButton y mutableStateListOf:
@Composable fun MultiSelectConnectedButtonGroupSample() { val options = listOf("Work", "Restaurant", "Coffee", "Search", "Home") val unCheckedIcons = listOf( AppIcons.Work, AppIcons.Restaurant, AppIcons.Coffee, AppIcons.Search, AppIcons.Home, ) val checkedIcons = listOf( AppIcons.WorkFilled, AppIcons.Restaurant, AppIcons.CoffeeFilled, AppIcons.Search, AppIcons.HomeFilled, ) val checked = remember { mutableStateListOf(false, false, false, false, false) } FlexBox( modifier = Modifier.padding(horizontal = 8.dp).fillMaxWidth(), config = { direction(FlexDirection.Row) wrap(FlexWrap.Wrap) columnGap(ButtonGroupDefaults.ConnectedSpaceBetween) rowGap(2.dp) }, ) { options.forEachIndexed { index, label -> ToggleButton( checked = checked[index], onCheckedChange = { checked[index] = it }, shapes = when (index) { 0 -> ButtonGroupDefaults.connectedLeadingButtonShapes() options.lastIndex -> ButtonGroupDefaults.connectedTrailingButtonShapes() else -> ButtonGroupDefaults.connectedMiddleButtonShapes() }, ) { Icon( painter = rememberVectorPainter( if (checked[index]) checkedIcons[index] else unCheckedIcons[index] ), contentDescription = null, ) Spacer(Modifier.size(ToggleButtonDefaults.IconSpacing)) Text(label) } } } }