Grup tombol

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:

  1. Grup tombol standar: Menambahkan interaksi antara tombol yang berdekatan sehingga tombol tersebut saling merespons saat ditekan.
  2. Grup tombol terhubung: Mengelompokkan tombol beralih untuk memungkinkan pengguna memilih opsi, beralih tampilan, atau mengurutkan elemen di halaman.
Grup tombol standar di sebelah kiri dan grup tombol terhubung di sebelah kanan.
Gambar 1. Grup tombol standar (1, kiri) dan grup tombol terhubung (2, kanan).

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 yang berisi tombol dengan berbagai bentuk dan ukuran.
Gambar 2. Grup tombol yang berisi tombol dengan berbagai bentuk dan ukuran.

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.

Perilaku grup tombol yang terhubung.
Gambar 3. Perilaku grup tombol terhubung yang responsif.

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)
            }
        }
    }
}