Tombol pisah

Tombol terpisah menentukan grup dua tombol, dengan tombol utama melakukan tindakan utama dan tombol berikutnya membuka kumpulan opsi sekunder yang terkait secara kontekstual.

Saat diaktifkan, tombol menu di akhir akan memutar ikonnya dan berubah bentuk. Tombol terpisah dapat ditempatkan sendiri atau bersama tombol lain dengan ukuran yang sama.

Menggunakan tombol terpisah

  • Membuka menu untuk memberi pengguna opsi sekunder yang terkait dengan tindakan utama.
  • Berfungsi sendiri atau bersama tombol standar dan tombol ikon.
  • Biasanya membuka menu, tetapi dapat disesuaikan untuk membuka komponen lain seperti kartu.
  • Mendukung lima ukuran yang sama dengan tombol dan tombol ikon: ekstra kecil (XS), kecil (S), sedang (M), besar (L), dan ekstra besar (XL).
Tombol pisah dalam berbagai ukuran dan gaya warna.
Gambar 1. Tombol terpisah dalam berbagai ukuran dan gaya warna.

Contoh

Tombol terpisah terisi

Tombol terpisah terisi adalah varian penekanan tinggi yang digunakan untuk tindakan penting atau final. Cuplikan berikut mengimplementasikan tombol terpisah terisi menggunakan SplitButtonLayout dengan SplitButtonDefaults.LeadingButton dan SplitButtonDefaults.TrailingButton:

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

Tombol pisah tonal

Tombol pisah tonal adalah varian penekanan sedang dari tombol pisah. Cuplikan berikut menggunakan SplitButtonDefaults.TonalLeadingButton dan SplitButtonDefaults.TonalTrailingButton di dalam SplitButtonLayout:

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