ปุ่มแยก

ปุ่มแยกกำหนดกลุ่มปุ่ม 2 ปุ่ม โดยปุ่มแรกจะดำเนินการหลัก และปุ่มหลังจะเปิดชุดตัวเลือกที่เกี่ยวข้องตามบริบทรอง

เมื่อเปิดใช้งาน ปุ่มเมนูต่อท้ายจะหมุนไอคอนและเปลี่ยนรูปร่าง ปุ่มแยกสามารถวางเดี่ยวๆ หรือวางเคียงข้างปุ่มอื่นๆ ที่มีขนาดเท่ากันได้

การใช้ปุ่มแยก

  • เปิดเมนูเพื่อให้ผู้ใช้มีตัวเลือกรองที่เกี่ยวข้องกับการดำเนินการหลัก
  • ใช้เดี่ยวๆ หรือใช้ร่วมกับปุ่มมาตรฐานและปุ่มไอคอนก็ได้
  • โดยปกติแล้วจะเปิดเมนู แต่สามารถปรับแต่งให้เปิดคอมโพเนนต์อื่นๆ เช่น การ์ด ได้
  • รองรับ 5 ขนาดเช่นเดียวกับปุ่มและปุ่มไอคอน ได้แก่ เล็กพิเศษ (XS), เล็ก (S), กลาง (M), ใหญ่ (L) และใหญ่พิเศษ (XL)
ปุ่มแยกในขนาดและสไตล์สีต่างๆ
รูปที่ 1 ปุ่มแยกในหลายขนาดและสไตล์สี

ตัวอย่าง

ปุ่มแยกแบบทึบ

ปุ่มแยกแบบเต็มเป็นตัวแปรที่เน้นสูงซึ่งใช้สำหรับการดำเนินการที่สำคัญหรือขั้นสุดท้าย ข้อมูลโค้ดต่อไปนี้จะใช้ปุ่มแยกแบบเติมโดยใช้ SplitButtonLayout กับ SplitButtonDefaults.LeadingButton และ 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,
                )
            }
        },
    )
}

ปุ่มแยกแบบมีโทนสี

ปุ่มแยกแบบใช้โทนสีเป็นตัวแปรที่เน้นปานกลางของปุ่มแยก ข้อมูลโค้ดต่อไปนี้ใช้ SplitButtonDefaults.TonalLeadingButton และ SplitButtonDefaults.TonalTrailingButton ภายใน 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,
                )
            }
        },
    )
}