Skip to content

Menu 菜单

使用

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

TIP

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

顶栏

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

导航菜单默认为垂直模式,通过将 mode 属性设置为 horizontal 来使导航菜单变更为水平模式。 另外,在菜单中通过 sub-menu 组件可以生成二级菜单。 Menu 还提供了background-colortext-coloractive-text-color,分别用于设置菜单的背景色、菜单的文字颜色和当前激活菜单的文字颜色。

左右

您可以将菜单项放置在左边或右边。

侧栏

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

通过 k-menu-item-group 组件可以实现菜单进行分组,分组名可以通过 title 属性直接设定,也可以通过具名 slot 来设定。

Collapse 折叠面板

垂直导航菜单可以被折叠

弹出层偏移量

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

API

参数名描述类型默认值
index唯一标志string | nullnull
routeVue Router 路径对象object
disabled是否禁用booleanfalse
方法名描述类型
open展开指定的 sub-menumethod
close收起指定的 sub-menumethod
插槽名描述参数
default自定义默认内容-
参数名描述类型默认值
index唯一标志string
popper-class为 popper 添加类名string
show-timeout子菜单出现之前的延迟,(继承 menu 的 show-timeout 配置)number
hide-timeout子菜单消失之前的延迟,(继承 menu 的 hide-timeout 配置)number
disabled是否禁用booleanfalse
popper-append-to-body(已废弃)是否将弹出菜单插入至 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父菜单收起且子菜单关闭时的图标,expand-close-icon 和 expand-open-icon 需要一起配置才能生效string | Component
collapse-open-icon父菜单收起且子菜单打开时的图标,expand-open-icon 和 expand-close-icon 需要一起配置才能生效string | Component
事件名描述类型
select菜单激活回调callback
opensub-menu 展开的回调callback
closesub-menu 收起的回调callback
方法名描述类型
open展开指定的 sub-menumethod
close收起指定的 sub-menumethod
插槽名描述参数
default自定义默认内容-
title自定义标题 内容-
参数名描述类型默认值
index唯一标志string | nullnull
routeVue Router 路径对象object
disabled是否禁用booleanfalse
事件名描述类型
click菜单点击时的回调函数Function
插槽名描述参数
default自定义默认内容-
title自定义标题内容-
参数名描述类型默认值
title组标题stringnull
插槽名描述参数
default默认默认内容-
title自定义组标题内容-