Düğme grupları, düğmeleri düzenler ve düğmeler ile simge düğmelerine koordineli şekil, hareket ve genişlik değişiklikleri uygulayarak aralarında etkileşimler ekler. İki tür düğme grubu vardır:
- Standart düğme grubu: Bitişik düğmeler arasında etkileşim ekler. Böylece düğmeler basıldığında birbirine yanıt verir.
- Bağlı düğme grubu: Kullanıcıların seçenekleri belirlemesine, görünümler arasında geçiş yapmasına veya sayfadaki öğeleri sıralamasına olanak tanımak için açma/kapatma düğmelerini gruplandırır.
Düğme gruplarını kullanma
- Düğmelere basıldığında veya düğmeler seçildiğinde şekil dönüştürme uygular.
- Bağlı düğme grupları, parçalı düğmelerin yerini alır.
- Tüm düğme boyutlarıyla çalışır: çok küçük (XS), küçük (S), orta (M), büyük (L) ve çok büyük (XL).
- Tekli seçim, çoklu seçim ve seçim gerektiren kalıpları destekler.
Standart düğme grubu
Düğmeleri yatay bir sıraya yerleştirmek için ButtonGroup composable'ını kullanın. Bu composable, basılan öğeyi genişletir, komşu öğeleri sıkıştırır ve alan sınırlı olduğunda ek öğeleri taşma menüsüne taşır. Düğme grupları ikinci satıra kaydırılmak yerine tek bir satırda kalmalıdır.
Aşağıdaki snippet'te, taşma menüsü göstergesi olan standart bir düğme grubunun nasıl uygulanacağı gösterilmektedir:
@Composable fun ButtonGroupSample() { val numButtons = 10 ButtonGroup( overflowIndicator = { menuState -> ButtonGroupDefaults.OverflowIndicator(menuState = menuState) } ) { for (i in 0 until numButtons) { clickableItem(onClick = {}, label = "$i") } } }
Bağlı düğme grubu
ToggleButton bileşenleri ve ButtonGroupDefaults bağlı şekillerle oluşturulan tekli veya çoklu seçim kalıpları için bağlı düğme gruplarını kullanın.
Tekli seçim
Kullanıcı, birbirini dışlayan bir gruptan tek bir seçenek belirlediğinde tek seçimli bağlı düğme grubunu kullanın. Aşağıdaki snippet, ToggleButton ve Role.RadioButton kullanarak tek seçimli bağlı düğme grubu uygular:
@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) } } } }
Çoklu seçim
Kullanıcı sıfır veya daha fazla seçeneği bağımsız olarak açıp kapatabiliyorsa çoklu seçim bağlantılı düğme grubu kullanın. Aşağıdaki snippet, ToggleButton ve mutableStateListOf kullanarak çoklu seçim bağlantılı düğme grubu uygular:
@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) } } } }