Düğme grupları

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:

  1. Standart düğme grubu: Bitişik düğmeler arasında etkileşim ekler. Böylece düğmeler basıldığında birbirine yanıt verir.
  2. 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.
Solda standart düğme grupları, sağda ise bağlı düğme grupları gösteriliyor.
Şekil 1. Standart düğme grupları (1, solda) ve bağlı düğme grupları (2, sağda).

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.
Çeşitli şekil ve boyutlarda düğmeler içeren düğme grupları.
Şekil 2. Çeşitli şekil ve boyutlarda düğmeler içeren düğme grupları.

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.

Bağlı düğme grubu davranışı.
Şekil 3. Duyarlı bağlı düğme grubu davranışı.

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