Menu 菜单
uni-appH5微信小程序App
uni-app 跨端垂直导航菜单。支持一层子菜单展开/收起、激活项 v-model、收起为纯图标的 56px 窄栏。
何时使用
后台/应用侧边导航,需要一级分组或纯图标窄栏时。
何时不使用
顶部多级下拉导航或层级超过两级的树形导航。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
9:41
Menu 菜单 · uni-app H5 实时运行 新窗口打开
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | string | "\"\"" | 激活项 name,支持 v-model |
items | MenuItem[] | "[]" | 菜单项:{ name, label, icon?, disabled?, children? },children 支持一层子菜单 |
collapse | boolean | false | 收起为纯图标模式,宽度 56px,隐藏 label 与子菜单,子菜单以右侧飞出面板展示 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | string | 点击叶子项时更新激活项 |
select | MenuItem | 点击叶子项时触发,参数为该菜单项 |
示例
基础菜单
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' }]" />