Vue / 系统课时
菜单与路由联动
菜单与路由联动
企业应用里的菜单、面包屑和选中态本质上都由当前路由决定。若分别维护多套导航配置,页面改名或移动后很容易出现状态不一致。本节把路由元信息作为单一数据源,派生菜单、面包屑和当前高亮状态。
学习目标
- 用路由元信息统一描述导航标题、菜单显示和排序
- 从路由记录派生菜单与面包屑,减少重复配置
- 正确处理当前菜单选中态和隐藏页面的导航归属
把导航信息放进路由元数据
路由记录可以保存稳定的导航描述,例如 title、menu、order 和 activeMenu。其中 menu: false 适合详情页、编辑页等不直接出现在侧栏中的页面;activeMenu 则让这些隐藏页面仍能高亮它们所属的列表菜单。

从当前路由派生导航状态
下面是片段示例,依赖项目已经安装并创建 vue-router@4 路由实例,并约定每条可导航路由通过 meta 提供标题、排序和显示规则。组件本身不再维护第二份菜单标题配置。
<script setup lang="ts">
import { computed } from 'vue'
import { RouterLink, useRoute, useRouter } from 'vue-router'
const route = useRoute()
const router = useRouter()
const menuItems = computed(() =>
router
.getRoutes()
.filter(record => record.meta.menu !== false && typeof record.meta.title === 'string')
.sort((a, b) => Number(a.meta.order ?? 0) - Number(b.meta.order ?? 0))
)
const breadcrumbs = computed(() =>
route.matched
.filter(record => typeof record.meta.title === 'string')
.map(record => String(record.meta.title))
)
const activeMenu = computed(() => String(route.meta.activeMenu ?? route.path))
</script>
<template>
<aside>
<RouterLink
v-for="item in menuItems"
:key="item.path"
:to="item.path"
:class="{ active: activeMenu === item.path }"
>
{{ item.meta.title }}
</RouterLink>
</aside>
<nav aria-label="breadcrumb">
<span v-for="(title, index) in breadcrumbs" :key="`${title}-${index}`">
{{ index > 0 ? ' / ' : '' }}{{ title }}
</span>
</nav>
</template>预期结果
路由切换后,菜单列表、面包屑和高亮项会随当前 route 自动更新。
详情页设置 meta.activeMenu 为所属列表页路径后,详情页可以不出现在菜单中,但对应列表菜单仍保持高亮。菜单生成要处理的边界
router.getRoutes() 返回扁平化的路由记录,因此简单的单层菜单可以直接过滤和排序。如果产品需要二级或三级菜单,应从保留父子结构的路由配置生成菜单树,而不是根据扁平结果重新猜测层级关系。
用于导航定位的路由名称和路径应保持稳定。页面展示标题可以修改,但 name 或 path 往往还会被权限、缓存和程序跳转引用,因此不能把展示文案当作导航对象的唯一标识。
面包屑优先使用 route.matched
route.matched 已按父路由到子路由的顺序提供当前匹配链,非常适合生成面包屑。相比直接切割 URL,它能够保留真正的路由层级,并正确面对动态参数、别名和布局路由,不会把 /users/42/edit 的每一段都误认为业务层级。
如果某个中间路由只是布局容器,可以约定 meta.breadcrumb = false 并在派生时过滤。是否展示面包屑因此由路由语义决定,而不是在组件模板中不断增加具体路径判断。
让路由成为单一事实源
菜单、面包屑和选中态应该共享路由元信息,但访问权限仍应由权限系统控制。更稳妥的顺序是先根据当前用户权限得到可访问路由集合,再从这个集合生成菜单,而不是只把未授权菜单隐藏起来却仍允许直接访问对应地址。
导航信息统一由路由派生后,新增页面通常只需维护一处配置。页面标题、显示规则、排序和高亮归属都能随当前路由自动同步,也为后续把菜单与布局框架、权限模型组合在一起留下清晰边界。