Grup tombol mengatur tombol dan menambahkan interaksi di antaranya dengan menerapkan perubahan bentuk, gerakan, dan lebar yang terkoordinasi pada tombol dan tombol ikon. Ada dua varian grup tombol:
- Grup tombol standar: Menambahkan interaksi antara tombol yang berdekatan sehingga tombol tersebut saling merespons saat ditekan.
- Grup tombol terhubung: Mengelompokkan tombol beralih untuk memungkinkan pengguna memilih opsi, beralih tampilan, atau mengurutkan elemen di halaman.
Menggunakan grup tombol
- Menerapkan perubahan bentuk saat tombol ditekan atau dipilih.
- Grup tombol yang terhubung menggantikan tombol tersegmentasi.
- Berfungsi dengan semua ukuran tombol: ekstra kecil (XS), kecil (S), sedang (M), besar (L), dan ekstra besar (XL).
- Mendukung pola pilihan tunggal, multi-pilihan, dan pilihan wajib.
Grup tombol standar
Gunakan composable ButtonGroup untuk menempatkan tombol dalam urutan horizontal
yang meluaskan item yang ditekan, mengompresi item di sekitarnya, dan memindahkan item
tambahan ke menu tambahan saat ruang terbatas. Grup tombol harus tetap berada di
satu baris, bukan digabungkan ke baris kedua.
Cuplikan berikut menunjukkan cara menerapkan grup tombol standar dengan indikator menu tambahan:
@Composable fun ButtonGroupSample() { val numButtons = 10 ButtonGroup( overflowIndicator = { menuState -> ButtonGroupDefaults.OverflowIndicator(menuState = menuState) } ) { for (i in 0 until numButtons) { clickableItem(onClick = {}, label = "$i") } } }
Grup tombol terhubung
Gunakan grup tombol terhubung untuk pola pilihan tunggal atau pilihan ganda yang dibuat
dengan composable ToggleButton dan bentuk terhubung
ButtonGroupDefaults.
Satu pilihan
Gunakan grup tombol terhubung pilihan tunggal saat pengguna memilih satu opsi dari
set yang saling eksklusif. Cuplikan berikut mengimplementasikan grup tombol terhubung
pilihan tunggal menggunakan ToggleButton dan 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) } } } }
Pilihan ganda
Gunakan grup tombol terhubung multi-pilih saat pengguna dapat mengaktifkan atau menonaktifkan nol atau beberapa
opsi secara independen. Cuplikan berikut mengimplementasikan grup tombol terhubung multi-pilih menggunakan ToggleButton dan 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) } } } }