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:
- Standardowa grupa przycisków: dodaje interakcję między sąsiadującymi przyciskami, dzięki czemu reagują one na siebie po naciśnięciu.
- 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.
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.
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.
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) } } } }