Menu 菜单DropdownMenu · Menu

点击一个按钮，弹出一列操作让用户挑一个执行。DropdownMenu 是带触发按钮的完整下拉菜单；右键触发见 ContextMenu；要从选项里选一个“值”而不是执行操作，用 Select。

下拉菜单

trigger 通常是 Button。菜单项可以带图标、快捷键提示（只是文字，不负责绑定按键）和禁用状态。点选后默认收起整个菜单。

上一次操作：还没有操作

tone 给菜单项上状态色：文字和图标用状态色，高亮换成同色的柔和底。危险操作（删除、退出）用 danger，并且放在最后、用分隔线隔开。

MenuCheckboxItem 和 MenuRadioItem 点选后默认不收起菜单，方便连续调整。MenuLabel 是分组小标题。DropdownMenu 的开关用 open / onOpenChange 受控。

菜单已关闭 · 网格线开 · 隐藏文件关 · 排序 updated

MenuSub 的 label 是触发项上的文字，children 是子菜单里的项。悬停、点击或按 → 展开，← 或 Esc 收回。子菜单尽量只用一层。

默认在触发按钮下方、左对齐，并且不窄于触发按钮。

Menu 是 role="menu" 的列表本体，可以不带触发按钮直接放在页面里（比如放进你自己的浮层）。此时没有“收起”的概念，点选只触发 onSelect。

属性	类型	默认值	说明
`icon`	`IconName \| ReactNode`	—	前置图标。
`shortcut`	`ReactNode`	—	右侧的快捷键提示，只是文字。
`tone`	`'neutral' \| 'success' \| 'warning' \| 'danger' \| 'info'`	`'neutral'`	状态色。
`disabled`	`boolean`	—	禁用：方向键会跳过，点击无效。
`onSelect`	`() => void`	—	被点选或用 Enter / Space 触发。
`closeOnSelect`	`boolean`	`true（勾选 / 单选项为 false）`	触发后是否收起整个菜单。
`textValue`	`string`	—	首字母跳转用的文字；默认取项里的文字内容。

属性	类型	默认值	说明
`MenuCheckboxItem · checked / defaultChecked`	`boolean`	—	是否勾选（受控 / 非受控）。
`MenuCheckboxItem · onCheckedChange`	`(checked: boolean) => void`	—	勾选状态变化时触发。
`MenuRadioGroup · value / defaultValue`	`string \| null`	—	选中项（受控 / 非受控）。
`MenuRadioGroup · onChange`	`(value: string) => void`	—	选中项变化时触发。
`MenuRadioItem · value`*	`string`	—	这一项的值，必须放在 MenuRadioGroup 里。
`MenuSub · label`*	`ReactNode`	—	触发项上的文字。
`MenuSub · children`*	`ReactNode`	—	子菜单里的项。
`MenuSub · icon / tone / disabled`	`—`	—	同 MenuItem。

属性	类型	默认值	说明
`focusOnOpen`	`'first' \| 'last' \| 'menu' \| null`	—	挂载时把焦点放到哪；null 表示不动焦点。
`bare`	`boolean`	—	不带浮层表面（放在自己的浮层里时用）。