Menu 菜单
WebH5
垂直导航菜单。支持一层子菜单展开/收起、激活项 v-model、收起为纯图标的 56px 窄栏。
何时使用
后台/应用侧边导航,需要一级分组或纯图标窄栏时。
何时不使用
顶部多级下拉导航或层级超过两级的树形导航。
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 | 点击叶子项时触发,参数为该菜单项 |
示例
后台侧边导航
示例加载中…
<Menu v-model="m1" :items="[
{ name: 'home', label: '工作台', icon: 'home' },
{ name: 'order', label: '订单管理', icon: 'menu' },
{ name: 'goods', label: '商品管理', icon: 'star' },
{ name: 'invite', label: '邀请有礼', icon: 'heart', disabled: true },
]" />带子菜单(设置分组)
示例加载中…
<Menu v-model="m2" :items="[
{ name: 'home', label: '工作台', icon: 'home' },
{ name: 'set', label: '设置', icon: 'settings', children: [
{ name: 'set-account', label: '账号与安全', icon: 'user' },
{ name: 'set-notify', label: '消息通知' },
{ name: 'set-privacy', label: '隐私权限', icon: 'lock' },
] },
]" />收起为图标栏
示例加载中…
<Menu v-model="m3" collapse :items="[
{ name: 'home', label: '工作台', icon: 'home' },
{ name: 'order', label: '订单管理', icon: 'menu' },
{ name: 'goods', label: '商品管理', icon: 'star' },
{ name: 'set', label: '设置', icon: 'settings' },
]" />事件监听
示例加载中…
<Menu v-model="m4" @select="console.log('选中菜单项:', $event)" :items="[
{ name: 'home', label: '工作台', icon: 'home' },
{ name: 'order', label: '订单管理', icon: 'menu' },
{ name: 'fav', label: '收藏夹', icon: 'star' },
]" />完整后台布局(子菜单 + 事件)
示例加载中…
<Stack :gap="8">
<Menu v-model="m5" @select="console.log('导航至:', $event.label)" :items="[
{ name: 'home', label: '工作台', icon: 'home' },
{ name: 'order', label: '订单管理', icon: 'menu', children: [
{ name: 'order-all', label: '全部订单' },
{ name: 'order-pending', label: '待处理' },
{ name: 'order-refund', label: '退款管理' },
] },
{ name: 'goods', label: '商品管理', icon: 'star' },
{ name: 'set', label: '设置', icon: 'settings', children: [
{ name: 'set-account', label: '账号与安全' },
{ name: 'set-notify', label: '消息通知' },
] },
]" />
</Stack>Playground
加载中…
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Menu 文档(含手机预览)。