| 属性 | 类型 | 默认值 | 说明 |
|---|
label | string | — | 菜单的无障碍名称,写到 aria-label 上。标题文字本身说不清这个菜单是干什么的时候设置它。 |
size | 'sm' | 'md' | 'lg' | 'md' | 菜单宽度档,同时决定每一项的内边距。 |
minWidth | number | string | — | 覆盖按档位算出的最小宽度。数字按像素处理。 |
focusRequest | 'first' | 'last' | null | null | 菜单打开后把焦点放到第一项或最后一项。标题的弹出面板会自己传进来,所以用键盘打开时焦点直接落在条目上。 |
| 名称 | 说明 |
|---|
close | 按下 Escape 时触发。SideNavHeading 和 TopNavHeading 已经接住了它,会把弹出面板关掉。 |
| 属性 | 类型 | 默认值 | 说明 |
|---|
label | string | — | 条目的主要文字。想在条目里放富文本时改用默认插槽。 |
description | string | — | 文字下面的一行辅助说明。 |
href | string | — | 给出后这个条目渲染成链接。 |
as | NavLinkComponent | 'a' | 链接的根组件,例如 RouterLink。此时条目会同时写 href 和 to。 |
iconClass | string | — | 文字前面那个图标的 CSS 类名。 |
isDisabled | boolean | false | 禁用这个条目。点击不响应,方向键和首字母查找也会跳过它。 |
| 名称 | 载荷 | 说明 |
|---|
click | MouseEvent | 激活这个条目时触发,触发时机在菜单收起之前。 |
| 名称 | 说明 |
|---|
default | 富文本内容,替代 label 属性的纯文字。 |
icon | 图标内容,优先于 iconClass 画出来的字形。 |
整个菜单是一个 role="menu":方向键在条目之间移动并循环,直接按字母会跳到以该字母开头的下一个条目,Escape 关掉面板并把焦点还给标题。