Grupy przycisków

Grupy przycisków porządkują przyciski i dodają interakcje między nimi, stosując skoordynowane zmiany kształtu, ruchu i szerokości przycisków i przycisków ikon. Dostępne są 2 warianty grup przycisków:

  1. Standardowa grupa przycisków: dodaje interakcję między sąsiadującymi przyciskami, dzięki czemu reagują one na siebie po naciśnięciu.
  2. Połączona grupa przycisków: grupuje przyciski przełączania, aby umożliwić użytkownikom wybieranie opcji, przełączanie widoków lub sortowanie elementów na stronie.
Standardowe grupy przycisków po lewej stronie i połączone grupy przycisków po prawej stronie.
Rysunek 1. Standardowe grupy przycisków (1, po lewej) i połączone grupy przycisków (2, po prawej).

Korzystanie z grup przycisków

  • Stosuje przekształcanie kształtu po naciśnięciu lub wybraniu przycisków.
  • Połączone grupy przycisków zastępują przyciski segmentowane.
  • Działa ze wszystkimi rozmiarami przycisków: bardzo małym (XS), małym (S), średnim (M), dużym (L) i bardzo dużym (XL).
  • Obsługuje wzorce z wyborem pojedynczym, wielokrotnym i wymaganym.
Grupy przycisków zawierające przyciski o różnych kształtach i rozmiarach.
Rysunek 2. Grupy przycisków zawierające przyciski o różnych kształtach i rozmiarach.

Standardowa grupa przycisków

Użyj funkcji kompozycyjnej ButtonGroup, aby umieścić przyciski w poziomej sekwencji, która rozwija naciśnięty element, kompresuje sąsiednie elementy i przenosi dodatkowe elementy do rozszerzonego menu, gdy ilość miejsca jest ograniczona. Grupy przycisków powinny znajdować się w jednym wierszu, a nie zawijać się do drugiego.

Poniższy fragment kodu pokazuje, jak wdrożyć standardową grupę przycisków ze wskaźnikiem rozszerzonego menu:

@Composable
fun ButtonGroupSample() {
    val numButtons = 10
    ButtonGroup(
        overflowIndicator = { menuState ->
            ButtonGroupDefaults.OverflowIndicator(menuState = menuState)
        }
    ) {
        for (i in 0 until numButtons) {
            clickableItem(onClick = {}, label = "$i")
        }
    }
}

Grupa połączonych przycisków

Używaj połączonych grup przycisków w przypadku wzorców wyboru pojedynczego lub wielokrotnego utworzonych za pomocą funkcji kompozycyjnych ToggleButton i połączonych kształtów ButtonGroupDefaults.

Zachowanie połączonej grupy przycisków.
Rysunek 3. Elastyczne dopasowywanie się połączonej grupy przycisków.

Wybór pojedynczy

Używaj połączonej grupy przycisków z możliwością wyboru jednej opcji, gdy użytkownik wybiera jedną opcję z wykluczającego się wzajemnie zestawu. Ten fragment kodu implementuje grupę połączonych przycisków z możliwością wyboru jednej opcji, używając ToggleButton i 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)
            }
        }
    }
}

Wybór wielokrotny

Używaj grupy połączonych przycisków wielokrotnego wyboru, gdy użytkownik może niezależnie przełączać co najmniej 1 opcję. Poniższy fragment kodu implementuje grupę połączonych przycisków wielokrotnego wyboru za pomocą ToggleButton i 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)
            }
        }
    }
}