เมนูแบบเลื่อนลงช่วยให้ผู้ใช้คลิกไอคอน ช่องข้อความ หรือคอมโพเนนต์อื่นๆ แล้วเลือกจากรายการตัวเลือกบนพื้นผิวชั่วคราวได้ คู่มือนี้จะอธิบายวิธีสร้างทั้งเมนูพื้นฐานและเมนูที่ซับซ้อนมากขึ้นซึ่งมีตัวแบ่งและไอคอน
แพลตฟอร์ม API
ใช้คอมโพเนนต์ DropdownMenu, DropdownMenuItem, IconButton และ ExposedDropdownMenuBox เพื่อใช้เมนูแบบเลื่อนลง คอมโพเนนต์ DropdownMenu และ DropdownMenuItem ใช้เพื่อแสดงรายการเมนู ส่วน IconButton หรือคอมโพเนนต์อื่นๆ สามารถทริกเกอร์การแสดงเมนูได้
ExposedDropdownMenuBox ใช้เพื่อสร้างเมนูที่แนบมากับช่องข้อความ
พารามิเตอร์หลักสำหรับคอมโพเนนต์ DropdownMenu มีดังนี้
expanded: ระบุว่าเมนูแสดงอยู่หรือไม่onDismissRequest: ใช้เพื่อจัดการการปิดเมนูcontent: เนื้อหาที่ประกอบกันได้ของเมนู ซึ่งโดยปกติจะมีDropdownMenuItemที่ประกอบกันได้
พารามิเตอร์หลักสำหรับ DropdownMenuItem มีดังนี้
text: กำหนดเนื้อหาที่แสดงในรายการเมนูonClick: Callback เพื่อจัดการการโต้ตอบกับรายการในเมนู
สร้างเมนูแบบเลื่อนลงพื้นฐาน
ข้อมูลโค้ดต่อไปนี้แสดงการใช้งาน DropdownMenu ขั้นต่ำ
@Composable fun MinimalDropdownMenu() { var expanded by remember { mutableStateOf(false) } Box( modifier = Modifier .padding(16.dp) ) { IconButton(onClick = { expanded = !expanded }) { Icon(painter = rememberVectorPainter(AppIcons.MoreVert), contentDescription = "More options") } DropdownMenu( expanded = expanded, onDismissRequest = { expanded = false } ) { DropdownMenuItem( text = { Text("Option 1") }, onClick = { /* Do something... */ } ) DropdownMenuItem( text = { Text("Option 2") }, onClick = { /* Do something... */ } ) } } }
ประเด็นสำคัญเกี่ยวกับโค้ด
- กำหนด
DropdownMenuพื้นฐานที่มีรายการเมนู 2 รายการ - พารามิเตอร์
expandedจะควบคุมการแสดงผลของเมนูเป็นแบบขยายหรือยุบ - พารามิเตอร์
onDismissRequestจะกำหนด Callback ที่จะทำงานเมื่อผู้ใช้ปิดเมนู - Composable
DropdownMenuItemแสดงถึงรายการที่เลือกได้ในเมนูแบบเลื่อนลง IconButtonจะทริกเกอร์การขยายและยุบเมนู
ผลลัพธ์
สร้างเมนูแบบเลื่อนลงที่ยาวขึ้น
DropdownMenu จะเลื่อนได้โดยค่าเริ่มต้นหากไม่สามารถแสดงรายการเมนูทั้งหมดพร้อมกันได้ ข้อมูลโค้ดต่อไปนี้จะสร้างเมนูแบบเลื่อนลงที่ยาวขึ้นและเลื่อนได้
@Composable fun LongBasicDropdownMenu() { var expanded by remember { mutableStateOf(false) } // Placeholder list of 100 strings for demonstration val menuItemData = List(100) { "Option ${it + 1}" } Box( modifier = Modifier .padding(16.dp) ) { IconButton(onClick = { expanded = !expanded }) { Icon(painter = rememberVectorPainter(AppIcons.MoreVert), contentDescription = "More options") } DropdownMenu( expanded = expanded, onDismissRequest = { expanded = false } ) { menuItemData.forEach { option -> DropdownMenuItem( text = { Text(option) }, onClick = { /* Do something... */ } ) } } } }
ประเด็นสำคัญเกี่ยวกับโค้ด
DropdownMenuจะเลื่อนได้เมื่อความสูงรวมของเนื้อหาเกินพื้นที่ที่ใช้ได้ โค้ดนี้จะสร้างDropdownMenuที่เลื่อนได้ซึ่งแสดงรายการตัวยึดตำแหน่ง 100 รายการ- ลูป
forEachจะสร้างคอมโพสิเบิลDropdownMenuItemแบบไดนามิก ระบบไม่ได้สร้างรายการแบบ Lazy ซึ่งหมายความว่าระบบจะสร้างรายการแบบเลื่อนลงทั้งหมด 100 รายการและมีอยู่ใน Composition IconButtonจะทริกเกอร์การขยายและยุบDropdownMenuเมื่อคลิกonClicklambda ภายในDropdownMenuItemแต่ละรายการช่วยให้คุณกำหนดการดำเนินการที่จะทำเมื่อผู้ใช้เลือกรายการเมนูได้
ผลลัพธ์
ข้อมูลโค้ดก่อนหน้าจะสร้างเมนูที่เลื่อนได้ต่อไปนี้
สร้างเมนูแบบเลื่อนลงที่ยาวขึ้นโดยใช้ตัวแบ่ง
ข้อมูลโค้ดต่อไปนี้แสดงการใช้งานเมนูแบบเลื่อนลงขั้นสูงขึ้น ในข้อมูลโค้ดนี้ ระบบจะเพิ่มไอคอนนำหน้าและต่อท้ายลงในรายการเมนู และตัวแบ่งจะแยกกลุ่มรายการเมนู
@Composable fun DropdownMenuWithDetails() { var expanded by remember { mutableStateOf(false) } Box( modifier = Modifier .fillMaxWidth() .padding(16.dp) ) { IconButton(onClick = { expanded = !expanded }) { Icon(painter = rememberVectorPainter(AppIcons.MoreVert), contentDescription = "More options") } DropdownMenu( expanded = expanded, onDismissRequest = { expanded = false } ) { // First section DropdownMenuItem( text = { Text("Profile") }, leadingIcon = { Icon(painter = rememberVectorPainter(AppIcons.Person), contentDescription = null) }, onClick = { /* Do something... */ } ) DropdownMenuItem( text = { Text("Settings") }, leadingIcon = { Icon(painter = rememberVectorPainter(AppIcons.Settings), contentDescription = null) }, onClick = { /* Do something... */ } ) HorizontalDivider() // Second section DropdownMenuItem( text = { Text("Send Feedback") }, leadingIcon = { Icon(painter = rememberVectorPainter(AppIcons.Feedback), contentDescription = null) }, trailingIcon = { Icon(painter = rememberVectorPainter(AppIcons.Send), contentDescription = null) }, onClick = { /* Do something... */ } ) HorizontalDivider() // Third section DropdownMenuItem( text = { Text("About") }, leadingIcon = { Icon(painter = rememberVectorPainter(AppIcons.Info), contentDescription = null) }, onClick = { /* Do something... */ } ) DropdownMenuItem( text = { Text("Help") }, leadingIcon = { Icon(painter = rememberVectorPainter(AppIcons.Help), contentDescription = null) }, trailingIcon = { Icon(painter = rememberVectorPainter(AppIcons.OpenInNew), contentDescription = null) }, onClick = { /* Do something... */ } ) } } }
รหัสนี้กำหนด DropdownMenu ภายใน Box
ประเด็นสำคัญเกี่ยวกับโค้ด
- พารามิเตอร์
leadingIconและtrailingIconจะเพิ่มไอคอนที่จุดเริ่มต้นและจุดสิ้นสุดของDropdownMenuItem IconButtonจะทริกเกอร์การขยายเมนูDropdownMenuมี ComposableDropdownMenuItemหลายรายการ ซึ่งแต่ละรายการแสดงถึงการดำเนินการที่เลือกได้- คอมโพสิเบิล
HorizontalDividerจะแทรกเส้นแนวนอนเพื่อแยกกลุ่มรายการเมนู
ผลลัพธ์
ข้อมูลโค้ดก่อนหน้าจะสร้างเมนูแบบเลื่อนลงที่มีไอคอนและตัวแบ่ง ดังนี้
การอัปเดต M3 Expressive
Material 3 Expressive เปิดตัว DropdownMenuPopup, DropdownMenuGroup และ CheckableDropdownMenuItem เป็นตัวเลือกเพิ่มเติมควบคู่ไปกับ DropdownMenu และ DropdownMenuItem เพื่อสร้างเมนูที่แบ่งกลุ่มด้วยรายการที่จัดกลุ่ม ช่องว่าง และสถานะที่เลือกได้
ดูข้อมูลเพิ่มเติมเกี่ยวกับการอัปเดต M3 Expressive สำหรับเมนูได้ที่หลักเกณฑ์เกี่ยวกับเมนูของ Material Design 3
เมนูที่แบ่งกลุ่ม
เมนูแบบแบ่งกลุ่มจะจัดกลุ่มการดำเนินการที่เกี่ยวข้องไว้ในส่วนภาพที่แยกจากกันโดยใช้ช่องว่างหรือตัวแบ่ง ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้เมนูแบบเลื่อนลงที่แบ่งกลุ่มด้วย DropdownMenuPopup, DropdownMenuGroup และ CheckableDropdownMenuItem
@OptIn(ExperimentalMaterial3Api::class) @Composable fun GroupedMenuSample() { val groupInteractionSource = remember { MutableInteractionSource() } var expanded by remember { mutableStateOf(false) } val groupLabels = listOf("Modification", "Navigation") val groupItemLabels = listOf(listOf("Edit", "Settings"), listOf("Home", "More Options")) val groupItemLeadingIcons = listOf(listOf(AppIcons.Edit, AppIcons.Settings), listOf(null, AppIcons.Info)) val groupItemCheckedLeadingIcons = listOf( listOf(AppIcons.EditFilled, AppIcons.SettingsFilled), listOf(AppIcons.Check, AppIcons.InfoFilled), ) val groupItemTrailingIcons: List<List<ImageVector?>> = listOf(listOf(null, null), listOf(AppIcons.Home, AppIcons.MoreVert)) val groupItemCheckedTrailingIcons: List<List<ImageVector?>> = listOf(listOf(null, null), listOf(AppIcons.HomeFilled, AppIcons.MoreVert)) val groupItemSupportingText: List<List<String?>> = listOf(listOf("Edit mode", null), listOf(null, "Opens menu")) val checked = remember { listOf(mutableStateListOf(false, false), mutableStateListOf(false, false)) } Box(modifier = Modifier.fillMaxSize().wrapContentSize(Alignment.TopStart)) { // Icon button should have a tooltip associated with it for a11y. TooltipBox( positionProvider = TooltipDefaults.rememberTooltipPositionProvider(TooltipAnchorPosition.Above), tooltip = { PlainTooltip { Text("Localized description") } }, state = rememberTooltipState(), ) { IconButton(onClick = { expanded = true }) { Icon(painter = rememberVectorPainter(AppIcons.MoreVert), contentDescription = "Localized description") } } DropdownMenuPopup(expanded = expanded, onDismissRequest = { expanded = false }) { val groupCount = groupLabels.size groupLabels.fastForEachIndexed { groupIndex, label -> DropdownMenuGroup( shapes = MenuDefaults.groupShape(groupIndex, groupCount), interactionSource = groupInteractionSource, ) { MenuDefaults.DropdownMenuGroupLabel { Text(label) } HorizontalDivider(modifier = Modifier.padding(MenuDefaults.HorizontalDividerPadding)) val groupItemCount = groupItemLabels[groupIndex].size groupItemLabels[groupIndex].fastForEachIndexed { itemIndex, itemLabel -> CheckableDropdownMenuItem( text = { Text(itemLabel) }, supportingText = groupItemSupportingText[groupIndex][itemIndex]?.let { supportingText -> { Text(supportingText) } }, shapes = MenuDefaults.itemShape(itemIndex, groupItemCount), leadingIcon = groupItemLeadingIcons[groupIndex][itemIndex]?.let { iconData -> { Icon( painter = rememberVectorPainter(iconData), modifier = Modifier.size(MenuDefaults.LeadingIconSize), contentDescription = null, ) } }, checkedLeadingIcon = { Icon( painter = rememberVectorPainter(groupItemCheckedLeadingIcons[groupIndex][itemIndex]), modifier = Modifier.size(MenuDefaults.LeadingIconSize), contentDescription = null, ) }, trailingContent = if (checked[groupIndex][itemIndex]) { groupItemCheckedTrailingIcons[groupIndex][itemIndex]?.let { iconData -> { Icon( painter = rememberVectorPainter(iconData), modifier = Modifier.size(MenuDefaults.TrailingIconSize), contentDescription = null, ) } } } else { groupItemTrailingIcons[groupIndex][itemIndex]?.let { iconData -> { Icon( painter = rememberVectorPainter(iconData), modifier = Modifier.size(MenuDefaults.TrailingIconSize), contentDescription = null, ) } } }, checked = checked[groupIndex][itemIndex], onCheckedChange = { checked[groupIndex][itemIndex] = it }, ) } } if (groupIndex != groupCount - 1) { Spacer(Modifier.height(MenuDefaults.GroupSpacing)) } } if (checked.last().last()) { DropdownMenuButtonGroup() } } } } @Composable private fun DropdownMenuButtonGroup() { ButtonGroup( overflowIndicator = { menuState -> ButtonGroupDefaults.OverflowIndicator(menuState) }, modifier = Modifier.fillMaxWidth(), horizontalArrangement = Arrangement.spacedBy(2.dp, Alignment.CenterHorizontally), ) { customItem( buttonGroupContent = { FilledIconButton( onClick = {}, colors = IconButtonDefaults.filledIconButtonColors( containerColor = MenuDefaults.groupStandardContainerColor ), ) { Icon(painter = rememberVectorPainter(AppIcons.ThumbUp), contentDescription = "Localized description") } }, menuContent = { DropdownMenuItem( leadingIcon = { Icon(painter = rememberVectorPainter(AppIcons.ThumbUp), contentDescription = null) }, text = { Text("Thumbs up") }, onClick = {}, ) }, ) customItem( buttonGroupContent = { FilledIconButton( onClick = {}, colors = IconButtonDefaults.filledIconButtonColors( containerColor = MenuDefaults.groupStandardContainerColor ), ) { Icon(painter = rememberVectorPainter(AppIcons.ThumbDown), contentDescription = "Localized description") } }, menuContent = { DropdownMenuItem( leadingIcon = { Icon(painter = rememberVectorPainter(AppIcons.ThumbDown), contentDescription = null) }, text = { Text("Thumbs down") }, onClick = {}, ) }, ) customItem( buttonGroupContent = { FilledIconButton( onClick = {}, colors = IconButtonDefaults.filledIconButtonColors( containerColor = MenuDefaults.groupStandardContainerColor ), ) { Icon(painter = rememberVectorPainter(AppIcons.TagFaces), contentDescription = "Localized description") } }, menuContent = { DropdownMenuItem( leadingIcon = { Icon(painter = rememberVectorPainter(AppIcons.TagFaces), contentDescription = null) }, text = { Text("Emotes") }, onClick = {}, ) }, ) } }
แหล่งข้อมูลเพิ่มเติม
- Material Design: เมนู