เมนู

เมนูแบบเลื่อนลงช่วยให้ผู้ใช้คลิกไอคอน ช่องข้อความ หรือคอมโพเนนต์อื่นๆ แล้วเลือกจากรายการตัวเลือกบนพื้นผิวชั่วคราวได้ คู่มือนี้จะอธิบายวิธีสร้างทั้งเมนูพื้นฐานและเมนูที่ซับซ้อนมากขึ้นซึ่งมีตัวแบ่งและไอคอน

เมนูแบบเลื่อนลงที่มี 2 ตัวเลือกจะปรากฏขึ้น ไอคอนที่มีจุดแนวตั้ง 3 จุดแสดงว่าการคลิกจะเปิดเมนู
รูปที่ 1 เมนูแบบเลื่อนลงพื้นฐานที่มี 2 รายการ

แพลตฟอร์ม 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 จะทริกเกอร์การขยายและยุบเมนู

ผลลัพธ์

รูปที่ 2 เมนูแบบเลื่อนลงขนาดเล็กที่มีเพียง 2 ตัวเลือก

สร้างเมนูแบบเลื่อนลงที่ยาวขึ้น

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 เมื่อคลิก
  • onClick lambda ภายใน DropdownMenuItem แต่ละรายการช่วยให้คุณกำหนดการดำเนินการที่จะทำเมื่อผู้ใช้เลือกรายการเมนูได้

ผลลัพธ์

ข้อมูลโค้ดก่อนหน้าจะสร้างเมนูที่เลื่อนได้ต่อไปนี้

รูปที่ 3 เมนูแบบเลื่อนลงที่ยาวและเลื่อนได้

สร้างเมนูแบบเลื่อนลงที่ยาวขึ้นโดยใช้ตัวแบ่ง

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

@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 มี Composable DropdownMenuItem หลายรายการ ซึ่งแต่ละรายการแสดงถึงการดำเนินการที่เลือกได้
  • คอมโพสิเบิล HorizontalDivider จะแทรกเส้นแนวนอนเพื่อแยกกลุ่มรายการเมนู

ผลลัพธ์

ข้อมูลโค้ดก่อนหน้าจะสร้างเมนูแบบเลื่อนลงที่มีไอคอนและตัวแบ่ง ดังนี้

รูปที่ 4 เมนูแบบเลื่อนลงที่แบ่งออกเป็นส่วนๆ โดยมีไอคอนนำหน้าและต่อท้าย

การอัปเดต M3 Expressive

Material 3 Expressive เปิดตัว DropdownMenuPopup, DropdownMenuGroup และ CheckableDropdownMenuItem เป็นตัวเลือกเพิ่มเติมควบคู่ไปกับ DropdownMenu และ DropdownMenuItem เพื่อสร้างเมนูที่แบ่งกลุ่มด้วยรายการที่จัดกลุ่ม ช่องว่าง และสถานะที่เลือกได้

ตัวอย่างเมนูที่แสดงอารมณ์ของ M3
รูปที่ 5 รูปแบบเมนูแนวตั้ง Material 3 Expressive ที่มีช่องว่าง (1, ซ้าย) และตัวแบ่ง (2, ขวา)

ดูข้อมูลเพิ่มเติมเกี่ยวกับการอัปเดต 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 = {},
                )
            },
        )
    }
}

แหล่งข้อมูลเพิ่มเติม