Skip to content

导航标题菜单

@astryxdesign/core v0.7.1 · NavHeadingMenu

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

整个菜单是一个 role="menu":方向键在条目之间移动并循环,直接按字母会跳到以该字母开头的下一个条目,Escape 关掉面板并把焦点还给标题。