Menu 菜单

为网站提供导航功能的菜单。

TIP

在 SSR 场景下，您需要将组件包裹在 <client-only></client-only> 之中 (如: Nuxt) 和 SSG (e.g: VitePress).

顶栏

顶部栏菜单可以在各种场景中使用。

左右

侧栏

垂直菜单，可内嵌子菜单。

Collapse 折叠面板

垂直导航菜单可以被折叠

弹出层偏移量 2.4.4

当提供了 popperOffset 配置，会覆盖 Submenu 的 popper-offset.

属性名说明类型可选值默认值
mode菜单展示模式stringhorizontal / verticalvertical
collapse是否水平折叠收起菜单（仅在 mode 为 vertical 时可用）boolean—false
ellipsis是否省略多余的子项（仅在横向模式生效）boolean—true
ellipsis-icon 2.4.4自定义省略图标 (仅在水平模式下可用)string | Component——
popper-offset 2.4.4弹出层的偏移量(对所有子菜单有效)number—6
background-color菜单的背景颜色（十六进制格式）（已被废弃，使用--bg-color）string—#ffffff
text-color文字颜色（十六进制格式）（已被废弃，使用--text-color）string—#303133
active-text-color活动菜单项的文本颜色（十六进制格式）（已被废弃，使用--active-color）string—#409eff
default-active页面加载时默认激活菜单的 indexstring——
default-openeds默认打开的 sub-menu 的 index 的数组Array——
unique-opened是否只保持一个子菜单的展开boolean—false
menu-trigger子菜单打开的触发方式，只在 mode 为 horizontal 时有效。stringhover / clickhover
router是否启用 vue-router 模式。 启用该模式会在激活导航时以 index 作为 path 进行路由跳转 使用 default-active 来设置加载时的激活项。boolean—false
collapse-transition是否开启折叠动画boolean—true
popper-effect 2.2.26Tooltip 主题，内置了 dark / light 两种主题stringdark / lightdark
close-on-click-outside 2.4.4可选，单击外部时是否折叠菜单boolean—false
popper-class 2.5.0为 popper 添加类名string——
show-timeout 2.5.0菜单出现前的延迟number—300
hide-timeout 2.5.0菜单消失前的延迟number—300
方法名说明参数
open展开指定的子菜单index: 需要打开的 sub-menu 的 index
close关闭指定的子菜单index: 需要收起的 sub-menu 的 index
事件名说明回调参数
select菜单激活回调index: 选中菜单项的 index, indexPath: 选中菜单项的 index path, item: 选中菜单项, routeResult: vue-router 的返回值（如果 router 为 true）
opensub-menu 展开的回调index: 打开的 sub-menu 的 index, indexPath: 打开的 sub-menu 的 index path
closesub-menu 收起的回调index: 收起的 sub-menu 的 index, indexPath: 收起的 sub-menu 的 index path
插槽名说明子标签
—自定义默认内容SubMenu / Menu-Item / Menu-Item-Group
属性名说明类型可选值默认值
index唯一标志string——
popper-class为 popper 添加类名string——
show-timeout子菜单出现之前的延迟，(继承 menu 的 show-timeout 配置)number——
hide-timeout子菜单消失之前的延迟，(继承 menu 的 hide-timeout 配置)number——
disabled是否禁用boolean—false
popper-append-to-body deprecated是否将弹出菜单插入至 body 元素。 在菜单的定位出现问题时，可尝试修改该属性boolean—一级子菜单：true / 非一级子菜单：false
teleported是否将 popup 的下拉列表插入至 body 元素boolean—一级子菜单：true / 非一级子菜单：false
popper-offset弹出窗口的偏移量 (覆盖 popper的菜单)number——
expand-close-icon父菜单展开且子菜单关闭时的图标， expand-close-icon 和 expand-open-icon 需要一起配置才能生效string | Component——
expand-open-icon父菜单展开且子菜单打开时的图标， expand-open-icon 和 expand-close-icon 需要一起配置才能生效string | Component——
collapse-close-icon父菜单收起且子菜单关闭时的图标， collapse-close-icon 和 collapse-open-icon 需要一起配置才能生效string | Component——
collapse-open-icon父菜单收起且子菜单打开时的图标， collapse-open-icon 和 collapse-close-icon 需要一起配置才能生效string | Component——
插槽名说明子标签
—自定义默认内容SubMenu / Menu-Item / Menu-Item-Group
title自定义标题内容—
属性名说明类型可选值默认值
index唯一标志string/null—null
routeVue Router 路径对象object——
disabled是否禁用boolean—false
事件名说明回调参数
click菜单点击时的回调函数el-menu-item 实例
插槽名说明
—自定义默认内容
title自定义标题内容
属性名说明类型可选值默认值
title组标题string——
插槽名说明子标签
—默认插槽内容Menu-Item
title自定义组标题内容—

源代码

组件 • 文档

贡献者