菜单:指南
菜单在临时表面上显示选项列表。
用法
使用菜单呈现一组临时操作。如果需要在屏幕上始终显示操作,请改用工具栏工具栏显示与当前页面相关的常用操作。了解工具栏。
菜单比一组单选按钮单选按钮让用户从一组选项中选择一项。了解单选按钮或 芯片芯片可帮助用户输入信息、做出选择、筛选内容或触发操作。了解芯片 占用的空间更少。
色彩选项
菜单有两种色彩映射:
- 标准:基于表面色,视觉强调程度较低
- 鲜艳:基于第三级主题色,视觉强调程度较高
鲜艳菜单更突出,应谨慎使用。

打开菜单
菜单会临时显示在所有其他永久性 UI 元素之上。
应在以下情况下打开菜单:
- 选择某个元素,例如图标、按钮按钮让用户只需轻点一下即可执行操作并做出选择。了解按钮或文本框
- 执行特定操作来触发菜单,例如右键单击或长按
当需要执行额外操作时使用菜单,例如:
- 溢出菜单
- 文本框下拉菜单
- 选择菜单
- 上下文菜单


菜单项可以分组,以便快速浏览:
- 标准垂直菜单
- 分组垂直菜单
上下文菜单
上下文菜单提供一组用户可对项目执行的附加操作。辅助点击(例如鼠标右键单击或触控板双指轻点)会打开上下文菜单。

结构

- 菜单项
- 前导图标(可选)
- 菜单项文本
- 尾随图标(可选)
- 徽标(可选)
- 尾随文本(可选)
- 容器
- 辅助文本(可选)
- 标签文本(可选)
- 间隙(可选)
- 分隔线(可选)
菜单项
菜单项可以包含标签文本、前导图标、尾随图标和键盘快捷键。
当菜单项仅在特定条件下可用时,应将其显示为禁用禁用状态表示组件或元素不可交互。了解禁用状态,而不是移除。

间隙和分隔线(可选)
间隙和分隔线可用于分隔和分组菜单项。
间隙
使用间隙在视觉上将菜单项划分为不同组。间隙比分隔线更具表现力,能更清晰地体现菜单项之间的关系。
- 不要更改间隙大小
- 一个菜单中的间隙数量应限制为一到两个
- 不要在可滚动菜单中使用间隙

TIP
间隙目前在 Web 上不可用
分隔线
分隔线在菜单项之间形成更细微的分隔。在以下情况下使用分隔线:
- 可滚动菜单
- 带下拉菜单的文本框,此时不适合使用分组样式
在 Web 上,使用分隔线来分隔菜单项。

灵活性与插槽
菜单具有自定义插槽,支持更灵活的菜单项布局。
创建复杂菜单时,请将菜单项视为带有可替换插槽的容器。
插槽最适合用于简单内容,例如:
- 图片
- 进度指示器
- 色板

插槽的无障碍性
向菜单添加插槽时请谨慎:
- 确保菜单仍可无障碍访问
- 元素必须遵循菜单组件的规则和交互模式
- 保持相同的菜单项内边距
- 目标区域应至少为 48×48dp
不要在菜单项中添加按钮、开关或其他直接操作。嵌套元素应只执行一个操作。添加多个操作可能会破坏键盘导航和屏幕阅读器功能。

位置
菜单相对于窗口边缘定位。它通常出现在触发菜单的元素下方、旁边或前面。
如果菜单会因当前位置而被裁剪,应自动重新定位,以显示在触发菜单的元素的左侧、右侧或上方。


TIP
子菜单目前在 Jetpack Compose 中不可用
自适应设计
紧凑断点
考虑在小屏幕上将菜单改为底部工作表底部工作表显示锚定在屏幕底部的次要内容。了解底部工作表。底部工作表有更多空间显示额外的菜单项和更长的标签。

其他断点
在中等窗口宽度为 600dp 到 839dp,例如竖屏方向的平板电脑或可折叠设备。了解中等断点和扩展窗口宽度为 840dp 到 1199dp,例如横屏方向的平板电脑或可折叠设备,或桌面设备。了解扩展断点窗口中,当菜单与内容在上下文中一同显示时效果最佳。在更大的屏幕上,菜单还可以显示更多菜单项,并可使用子菜单来组织复杂的选项集。

行为
出现
当用户与页面上的元素(例如按钮、文本框、筛选芯片或高亮文本)交互时,菜单可能出现。
菜单在屏幕上的位置会影响其出现的位置和方式。如果菜单在屏幕顶部打开,它会向下展开以避免被裁剪。
动效
菜单使用进入和退出过渡。此动画在菜单与其触发元素之间建立关联。
当菜单展开时,触发元素会进入按下状态。选择菜单项时,触摸位置会出现水波纹效果。
在信息密集型产品中(例如桌面端),菜单可以立即打开以减少动效。
筛选
菜单可以包含文本框来筛选选项。此模式也称为自动完成。
当用户输入时,菜单选项列表会自动筛选并显示相关结果。这有助于用户从长列表中快速找到合适的选项。
当菜单被筛选时,菜单项会平滑过渡到新位置。
滚动
当无法一次显示所有菜单项时,菜单可以滚动。在此状态下,菜单会显示常驻滚动条。
如果菜单可滚动,请不要使用间隙;目前尚不支持在可滚动菜单中使用间隙。
选择
当菜单打开时,相应的按钮按钮让用户只需轻点一下即可执行操作并做出选择。了解按钮或图标按钮图标按钮帮助用户只需轻点一下即可执行次要操作。了解图标按钮应在视觉上保持不变,仅增加按下状态。
即使通过键盘快捷键打开菜单,触发元素也应保持这种显示。

单选和多选菜单
菜单支持单选或多选操作:
- 单选菜单一次只能选中一个菜单项。选择新菜单项时,之前选中的菜单项会自动取消选中。
- 多选菜单可以选中多个菜单项。菜单会保持打开状态,直到用户关闭。

焦点
当菜单有多个子菜单时,焦点会跟随当前悬停或聚焦的子菜单。
形状变形
当用户从一个子菜单移动到下一个子菜单时,聚焦子菜单的圆角会变得更圆润,而未聚焦子菜单的圆角会变得不那么圆润。这为菜单交互增添了动态效果。
密度
仅在 Web 上,密度级别控制元素之间的间距。提高密度会减少顶部和底部内边距。了解布局密度
