跳到主要内容

Menu 菜单 ​

uni-appH5微信小程序App

uni-app 跨端垂直导航菜单。支持一层子菜单展开/收起、激活项 v-model、收起为纯图标的 56px 窄栏。

何时使用 ​

后台/应用侧边导航,需要一级分组或纯图标窄栏时。

何时不使用 ​

顶部多级下拉导航或层级超过两级的树形导航。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
Menu 菜单 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
modelValuestring"\"\""激活项 name,支持 v-model
itemsMenuItem[]"[]"菜单项:{ name, label, icon?, disabled?, children? },children 支持一层子菜单
collapsebooleanfalse收起为纯图标模式,宽度 56px,隐藏 label 与子菜单,子菜单以右侧飞出面板展示

Events ​

名称载荷说明
update:modelValuestring点击叶子项时更新激活项
selectMenuItem点击叶子项时触发,参数为该菜单项

示例 ​

基础菜单 ​

vue
<Menu v-model="value1" :items="menuItems" />

折叠模式 ​

vue
<Menu v-model="value2" :items="menuItems" collapse />

禁用项 ​

vue
<Menu v-model="value3" :items="[{ name: 'home', label: '首页', icon: 'home' }, { name: 'lock', label: '审计日志', icon: 'lock', disabled: true }, { name: 'setting', label: '设置', icon: 'settings' }]" />