Bölme düğmesi

Bölünmüş düğme, iki düğmeli bir grubu tanımlar. Bu grupta, baştaki düğme birincil işlemi gerçekleştirir, sondaki düğme ise bağlamsal olarak alakalı ikincil seçenekler grubunu açar.

Etkinleştirildiğinde, sondaki menü düğmesi simgesini döndürür ve şeklini değiştirir. Bölünmüş düğmeler tek başına veya aynı boyuttaki diğer düğmelerle birlikte yerleştirilebilir.

Bölünmüş düğmeleri kullanma

  • Kullanıcılara birincil işlemle ilgili ikincil seçenekler sunan bir menü açar.
  • Tek başına veya standart düğmeler ve simge düğmeleriyle birlikte kullanılabilir.
  • Genellikle bir menü açar ancak kartlar gibi diğer bileşenleri açacak şekilde özelleştirilebilir.
  • Düğmeler ve simge düğmeleriyle aynı beş boyutu destekler: çok küçük (XS), küçük (S), orta (M), büyük (L) ve çok büyük (XL).
Birden fazla boyut ve renk stilinde bölünmüş düğmeler.
Şekil 1. Birden fazla boyut ve renk stilinde bölünmüş düğmeler.

Örnekler

Dolgulu bölünmüş düğme

Dolgulu bölünmüş düğme, önemli veya son işlemler için kullanılan yüksek vurgulu varyanttır. Aşağıdaki snippet, SplitButtonDefaults.LeadingButton ve SplitButtonDefaults.TrailingButton ile SplitButtonLayout kullanarak doldurulmuş bir bölünmüş düğme uygular:

@Composable
fun FilledSplitButtonSample() {
    var checked by rememberSaveable { mutableStateOf(false) }

    SplitButtonLayout(
        leadingButton = {
            SplitButtonDefaults.LeadingButton(onClick = { /* Do Nothing */ }) {
                Icon(
                    painter = rememberVectorPainter(AppIcons.Edit),
                    modifier = Modifier.size(SplitButtonDefaults.LeadingIconSize),
                    contentDescription = null,
                )
                Spacer(Modifier.size(ButtonDefaults.IconSpacing))
                Text("My Button")
            }
        },
        trailingButton = {
            SplitButtonDefaults.TrailingButton(
                checked = checked,
                onCheckedChange = { checked = it },
                modifier =
                    Modifier.semantics {
                        stateDescription = if (checked) "Expanded" else "Collapsed"
                        contentDescription = "Toggle Button"
                    },
            ) {
                val rotation: Float by
                    animateFloatAsState(
                        targetValue = if (checked) 180f else 0f,
                        label = "Trailing Icon Rotation",
                    )
                Icon(
                    painter = rememberVectorPainter(AppIcons.KeyboardArrowDown),
                    modifier =
                        Modifier.size(SplitButtonDefaults.TrailingIconSize).graphicsLayer {
                            this.rotationZ = rotation
                        },
                    contentDescription = null,
                )
            }
        },
    )
}

Tonlu bölünmüş düğme

Tonlu bölünmüş düğme, bölünmüş düğmenin orta vurgulu varyantıdır. Aşağıdaki snippet, SplitButtonLayout içinde SplitButtonDefaults.TonalLeadingButton ve SplitButtonDefaults.TonalTrailingButton kullanır:

@Composable
fun TonalSplitButtonSample() {
    var checked by rememberSaveable { mutableStateOf(false) }

    SplitButtonLayout(
        leadingButton = {
            SplitButtonDefaults.TonalLeadingButton(onClick = { /* Do Nothing */ }) {
                Icon(
                    painter = rememberVectorPainter(AppIcons.Edit),
                    modifier = Modifier.size(SplitButtonDefaults.LeadingIconSize),
                    contentDescription = null,
                )
                Spacer(Modifier.size(ButtonDefaults.IconSpacing))
                Text("My Button")
            }
        },
        trailingButton = {
            SplitButtonDefaults.TonalTrailingButton(
                checked = checked,
                onCheckedChange = { checked = it },
                modifier =
                    Modifier.semantics {
                        stateDescription = if (checked) "Expanded" else "Collapsed"
                        contentDescription = "Toggle Button"
                    },
            ) {
                val rotation: Float by
                    animateFloatAsState(
                        targetValue = if (checked) 180f else 0f,
                        label = "Trailing Icon Rotation",
                    )
                Icon(
                    painter = rememberVectorPainter(AppIcons.KeyboardArrowDown),
                    modifier =
                        Modifier.size(SplitButtonDefaults.TrailingIconSize).graphicsLayer {
                            this.rotationZ = rotation
                        },
                    contentDescription = null,
                )
            }
        },
    )
}