ปุ่มแยกกำหนดกลุ่มปุ่ม 2 ปุ่ม โดยปุ่มแรกจะดำเนินการหลัก และปุ่มหลังจะเปิดชุดตัวเลือกที่เกี่ยวข้องตามบริบทรอง
เมื่อเปิดใช้งาน ปุ่มเมนูต่อท้ายจะหมุนไอคอนและเปลี่ยนรูปร่าง ปุ่มแยกสามารถวางเดี่ยวๆ หรือวางเคียงข้างปุ่มอื่นๆ ที่มีขนาดเท่ากันได้
การใช้ปุ่มแยก
- เปิดเมนูเพื่อให้ผู้ใช้มีตัวเลือกรองที่เกี่ยวข้องกับการดำเนินการหลัก
- ใช้เดี่ยวๆ หรือใช้ร่วมกับปุ่มมาตรฐานและปุ่มไอคอนก็ได้
- โดยปกติแล้วจะเปิดเมนู แต่สามารถปรับแต่งให้เปิดคอมโพเนนต์อื่นๆ เช่น การ์ด ได้
- รองรับ 5 ขนาดเช่นเดียวกับปุ่มและปุ่มไอคอน ได้แก่ เล็กพิเศษ (XS), เล็ก (S), กลาง (M), ใหญ่ (L) และใหญ่พิเศษ (XL)
ตัวอย่าง
ปุ่มแยกแบบทึบ
ปุ่มแยกแบบเต็มเป็นตัวแปรที่เน้นสูงซึ่งใช้สำหรับการดำเนินการที่สำคัญหรือขั้นสุดท้าย ข้อมูลโค้ดต่อไปนี้จะใช้ปุ่มแยกแบบเติมโดยใช้ 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, ) } }, ) }