Schaltflächengruppen organisieren Schaltflächen und fügen Interaktionen zwischen ihnen hinzu, indem sie koordinierte Änderungen an Form, Bewegung und Breite auf Schaltflächen und Symbolschaltflächen anwenden. Es gibt zwei Varianten von Schaltflächengruppen:
- Standard-Button-Gruppe: Fügt eine Interaktion zwischen benachbarten Buttons hinzu, sodass sie aufeinander reagieren, wenn sie gedrückt werden.
- Verbundene Schaltflächengruppe: Gruppiert Ein/Aus-Schaltflächen, damit Nutzer Optionen auswählen, Ansichten wechseln oder Elemente auf einer Seite sortieren können.
Schaltflächengruppen verwenden
- Wendet Form-Morphing an, wenn Buttons gedrückt oder ausgewählt werden.
- Verbundene Schaltflächengruppen ersetzen segmentierte Schaltflächen.
- Funktioniert mit allen Schaltflächengrößen: extra klein (XS), klein (S), mittel (M), groß (L) und extra groß (XL).
- Unterstützt Muster für Einzelauswahl, Mehrfachauswahl und erforderliche Auswahl.
Standard-Schaltflächengruppe
Mit der zusammensetzbaren Funktion ButtonGroup können Sie Schaltflächen in einer horizontalen Sequenz platzieren, die das gedrückte Element maximiert, benachbarte Elemente minimiert und zusätzliche Elemente in ein Dreipunkt-Menü verschiebt, wenn der Platz begrenzt ist. Schaltflächengruppen sollten in einer einzigen Zeile bleiben und nicht in eine zweite Zeile umgebrochen werden.
Das folgende Snippet zeigt, wie eine Standard-Button-Gruppe mit einer Anzeige für das Dreipunkt-Menü implementiert wird:
@Composable fun ButtonGroupSample() { val numButtons = 10 ButtonGroup( overflowIndicator = { menuState -> ButtonGroupDefaults.OverflowIndicator(menuState = menuState) } ) { for (i in 0 until numButtons) { clickableItem(onClick = {}, label = "$i") } } }
Verbundene Schaltflächengruppe
Verwenden Sie verbundene Schaltflächengruppen für Muster mit Einfach- oder Mehrfachauswahl, die mit ToggleButton-Kompositfunktionen und verbundenen ButtonGroupDefaults-Formen erstellt wurden.
Einzelauswahl
Verwenden Sie eine verbundene Schaltflächengruppe mit Einzelauswahl, wenn der Nutzer eine Option aus einer sich gegenseitig ausschließenden Gruppe auswählt. Im folgenden Snippet wird eine verbundene Schaltflächengruppe mit Einzelauswahl mithilfe von ToggleButton und Role.RadioButton implementiert:
@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) } } } }
Mehrfachauswahl
Verwenden Sie eine verbundene Schaltflächengruppe mit Mehrfachauswahl, wenn der Nutzer null oder mehr Optionen unabhängig voneinander aktivieren oder deaktivieren kann. Im folgenden Snippet wird eine verbundene Schaltflächengruppe mit Mehrfachauswahl mithilfe von ToggleButton und mutableStateListOf implementiert:
@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) } } } }