Grupos de botones

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:

  1. Grupo de botones estándar: Agrega interacción entre botones adyacentes para que respondan entre sí cuando se presionan.
  2. 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.
Grupos de botones estándar a la izquierda y grupos de botones conectados a la derecha.
Figura 1: Grupos de botones estándar (1, izquierda) y grupos de botones conectados (2, derecha).

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.
Grupos de botones que contienen botones de varias formas y tamaños.
Figura 2: Grupos de botones con botones de varias formas y tamaños.

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.

Comportamiento del grupo de botones conectados.
Figura 3: Comportamiento responsivo del grupo de botones conectados.

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