el-menu动态加载路由,菜单的解决方案

本文介绍如何使用Vue和Element UI动态加载路由与菜单,并通过后端获取数据,实现多级菜单展示及隐藏路由功能。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

先看需要实现的效果

在这里插入图片描述
这里有一级也有二级菜单,注意二级菜单的父目录(”选项设置“点击不会跳转,只是展开目录),然后点击去详情页,需要跳到一个隐藏的路由,不在菜单展示的路由在这里插入图片描述
还有一点要注意,就是这里有两个router-view,整个页面是一个router-view,可以由LoginView和HomeView替换(当前看到的页面),而HomeView下又有一个router-view,需要用来展示部门,系统,超时,员工设置,不合格品列表和不合格品详情页。


以上的信息均需要在数据库的表中体现
先看看直接写在代码里需要哪些操作

const routes = [
  {
    path: '',
    name: 'login',
    component: LoginView,
  }
  ,
  {
    component: HomeView,
    children: [
      {
        path: '/home',
        name: '不合格品列表',
        component: BelowStandard
      },
      {
        path: '/product/:id',
        name: '不合格品详情',
        component: BelowStandardDetail
      }
    ]
  },
  {
    component: HomeView,
    name: '选项设置',
    children: [
      {
        path: '/employee',
        name: '员工设置',
        component: EmployeeConfig,
      },
      {
        path: '/department',
        name: '部门设置',
        component: DepartmentConfig
      },
      {
        path: '/system',
        name: '系统设置',
        component: SystemConfig
      },
      {
        path: '/warn',
        name: '超时提醒',
        component: WarmConfig
      }
    ]
  },
  {
    component: HomeView,
    children: [
      {
        path: '/statistics',
        name: '统计',
        component: DailyStatistics
      }
    ]
  },
  {
    component: HomeView,
    children: [
      {
        path: '/log',
        name: '日志管理',
        component: LogManager
      }
    ]
  },
]

这是路由,当要动态从数据库加载时,就不能写在这

<el-menu
            router
            active-text-color="#ffd04b"
            background-color="#000"
            class="el-menu-vertical-demo"
            :default-active="this.$route.path"
            text-color="#fff"
            @open=""
            @close=""
        >
          <el-menu-item index="/home">
            <template #title>
              不合格品列表
            </template>
          </el-menu-item>
          <el-sub-menu index="/subMenuConfig">
            <template #title>
              选项设置
            </template>
            <el-menu-item index="/department">部门设置</el-menu-item>
            <el-menu-item index="/system">系统设置</el-menu-item>
            <el-menu-item index="/warn">超时设置</el-menu-item>
            <el-menu-item index="/employee">员工设置</el-menu-item>
          </el-sub-menu>
          <el-menu-item index="/statistics">
            <span>统计</span>
          </el-menu-item>
          <el-menu-item index="/log">
            <span>日志管理</span>
          </el-menu-item>
        </el-menu>

这是el-menu开启了路由功能,所以能跳转路由,当动态加载的时候,这部分需要改造成v-for

数据库

在这里插入图片描述

说明:parent_id为0的即是一级目录,但是一级目录里一部分可以直接展示界面,一部分是展开二级目录,我这是以component字段为home/HomeView.vue来区分是展示二级目录。


现在开始写后端程序,返回菜单的json格式数据。
在这里插入图片描述

List<Menu> menuList = menuMapper.getMenuByUserId(UserUtils.getLoginUser().getId());
//根据ParentId分组
Map<Integer, List<Menu>> map = menuList.stream().collect(Collectors.groupingBy(Menu::getParentId, TreeMap::new,Collectors.toList()));
List<Menu> menus = map.get(0);//一级菜单
menus.forEach(menu->{//给有二级菜单的目录设置children属性
    List<Menu> children = map.get(menu.getId());
    menu.setChildren(children);
});
return menus;

从数据库查询到的数据格式如图,然后分一级二级菜单处理后,再返回前端

[
{
"name": "不合格品列表",
"path": "/home",
"component": "product/BelowStandard.vue",
"orderNum": 1,
"parentId": 0,
"isHidden": false,
"children": null
},
{
"name": "选项设置",
"path": "/subMenuConfig",
"component": "home/HomeView.vue",
"orderNum": 2,
"parentId": 0,
"isHidden": false,
"children": [
				{
				"name": "员工设置",
				"path": "/employee",
				"component": "config/EmployeeConfig.vue",
				"orderNum": 1,
				"parentId": 2,
				"isHidden": false,
				"children": null
				},
				{
				"name": "部门设置",
				"path": "/department",
				"component": "config/DepartmentConfig.vue",
				"orderNum": 2,
				"parentId": 2,
				"isHidden": false,
				"children": null
				},
				{
				"name": "系统设置",
				"path": "/system",
				"component": "config/SystemConfig.vue",
				"orderNum": 3,
				"parentId": 2,
				"isHidden": false,
				"children": null
				},
				{
				"name": "超时提醒",
				"path": "/warn",
				"component": "config/WarmConfig.vue",
				"orderNum": 4,
				"parentId": 2,
				"isHidden": false,
				"children": null
				}
]
},
{
"name": "统计",
"path": "/statistics",
"component": "statistics/DailyStatistics.vue",
"orderNum": 3,
"parentId": 0,
"isHidden": false,
"children": null
},
{
"name": "日志管理",
"path": "/log",
"component": "log/LogManager.vue",
"orderNum": 4,
"parentId": 0,
"isHidden": false,
"children": null
},
{
"name": "不合格品详情",
"path": "/product/:id",
"component": "product/BelowStandardDetail.vue",
"orderNum": 5,
"parentId": 0,
"isHidden": true,
"children": null
}
]

前端得到数据之后进行处理,再添加到路由,过程中遇到一个问题,vue-router4版本去掉addRoutes换成addRoute带来的问题困扰我很久,详情可以查看另一篇笔记:
第一次push路由不匹配

初始化路由:

router.beforeEach((to, from, next) => {//配置路由守卫
    if(to.path==='/'){
        next()
    }else if(store.state.user.id){
        initMenus(router,store,next,to)
    }else{
        next({ path: '/',query: {redirect: to.path}});
    }
});

export const initMenus = (router, store,next,to) => {//按F5刷新的话vuex里的会被清空,长度变为0
    if (store.state.menu !== null) {
        next()
    }else {
        axios.get("/menu").then(response => {
            if (response) {
                let responseData = response.data
                if (responseData.flag) {
                    store.state.menu = responseData.data
                    initRoute(router,store.state)
                    next({...to,replace:true})//解决router4版本的第一次路由不匹配问题
                } else {
                    this.$ElMessage.error('请求菜单失败')
                }
            }
        })
    }
}

const initRoute = (router,state)=> {
    const loadView = view => {//这种引入方式控制台不会报警告
        // 路由懒加载
        return () => import(`@/views/${view}`)
    };
    const menus = state.menu
    const firstLevelMenu = {
        children: [],
        component: loadView('home/HomeView.vue')
    }
    menus.forEach(menu=>{
        menu.component = loadView(menu.component)
        if(menu.children === null || menu.children.length === 0){
            firstLevelMenu.children.push(menu)
        }else{
            menu.children.forEach(children=>{
                children.component = loadView(children.component)
            })
            router.addRoute(menu)
        }
    })
    router.addRoute(firstLevelMenu)
}

完成这些配置之后,路由就能动态加载了,然后取出vuex中存储的menu生成el-menu

vuex中菜单大致如图

<el-menu
    router
    active-text-color="#ffd04b"
    background-color="#000"
    class="el-menu-vertical-demo"
    :default-active="this.$route.path"
    text-color="#fff"
    @open=""
    @close=""
>
  <template v-for="route of this.$store.state.menu">
    <template v-if="route.children === null || route.children.length === 0"><!--一级菜单-->
      <template v-if="!route.isHidden">
        <el-menu-item :index = "route.path">
          <span>{{route.name}}</span>
        </el-menu-item>
      </template>
    </template>
    <template v-else><!--二级菜单-->
      <template v-if="!route.isHidden">
        <el-sub-menu :index = "route.path">
          <template #title>
            <span>{{route.name}}</span>
          </template>
          <template v-for="children of route.children">
            <template v-if="!children.isHidden">
              <el-menu-item :index = "children.path">
                <span>{{children.name}}</span>
              </el-menu-item>
            </template>
          </template>
        </el-sub-menu>
      </template>
    </template>
  </template>
</el-menu>

实现效果展示
在这里插入图片描述
在这里插入图片描述

<think>我们正在解决的是:el-menu设置了默认激活菜单(default-active),但对应的router-view页面没有默认显示,需要点击菜单才能正常跳转的问题。 结合引用和常见情况,可能的原因和解决方案如下: 1. **路由匹配问题**:默认激活的菜单项(default-active)的index值必须与当前路由的path(或name)匹配。如果使用路由模式,index应设置为路由的path或name(取决于配置)。 2. **初始化时机问题**:在组件挂载时,可能还没有获取到默认激活的菜单项的值,导致设置失败。 3. **动态路由或异步数据问题**:如果菜单数据是异步获取的,可能在菜单渲染完成之后才设置default-active,导致不生效。 4. **未使用router模式**:如果el-menu没有设置router属性,那么点击菜单不会自动跳转,需要手动处理。 解决方案: **步骤1:确保el-menu开启路由模式** 在el-menu上添加`router`属性: ```html <el-menu :router="true" ...> 或 <el-menu router ...> ``` **步骤2:正确设置default-active** default-active的值应该是一个字符串,且必须与当前路由的path(或name)匹配。通常,我们会在data中设置一个变量(如activeMenu)来绑定default-active,并在mounted或created钩子中根据当前路由设置它。 例如: ```javascript data() { return { activeMenu: '' // 初始为空 } }, mounted() { // 根据当前路由设置激活菜单 this.activeMenu = this.$route.path; // 或者使用this.$route.name,取决于你的菜单index设置 } ``` **步骤3:处理异步菜单数据的情况** 如果菜单数据是异步获取的,那么需要在获取到菜单数据后再设置activeMenu,并且确保在菜单渲染时activeMenu已经有值。可以使用v-if控制菜单的渲染时机。 例如: ```html <el-menu v-if="menuData.length > 0" :default-active="activeMenu" router ...> ... </el-menu> ``` 然后在获取菜单数据的回调中设置activeMenu。 **步骤4:处理嵌套路由的情况** 如果当前路由是嵌套路由,可能菜单的index设置的是父路由的path,而当前路由的path是子路由的path,导致不匹配。此时,我们可以根据路由的匹配规则调整index的赋值,或者使用路由的name。 例如,在路由配置中给父路由设置name,然后菜单的index使用路由的name。 **步骤5:使用watch监听路由变化** 当通过其他方式(如浏览器前进后退)改变路由时,需要同步更新激活菜单。我们可以使用watch监听$route的变化。 ```javascript watch: { '$route'(to) { this.activeMenu = to.path; // 或to.name } } ``` **完整示例代码:** ```html <template> <div> <el-menu v-if="menuLoaded" // 确保菜单数据已加载 :default-active="activeMenu" router mode="horizontal" @select="handleSelect" > <el-menu-item index="/">首页</el-menu-item> <el-menu-item index="/result">检测结果</el-menu-item> </el-menu> <router-view></router-view> </div> </template> <script> export default { data() { return { activeMenu: '', menuLoaded: false // 初始未加载 } }, mounted() { // 模拟异步获取菜单 setTimeout(() => { // 假设菜单数据已经获取 this.menuLoaded = true; // 设置激活菜单 this.activeMenu = this.$route.path; // 根据当前路由设置 }, 500); }, watch: { $route(to) { // 路由变化时更新激活菜单 this.activeMenu = to.path; } }, methods: { handleSelect(index) { // 这里可以处理菜单选择事件,但开启router后会自动跳转,所以一般不需要 } } } </script> ``` **注意事项:** - 菜单项(el-menu-item)的index属性必须设置为对应的路由路径(或name),且与路由配置一致。 - 如果首页是根路径'/',那么菜单项index设置为'/'。 **引用中提到的问题参考:** 引用[1]:路由跳转但界面不刷新 -> 可能是路由配置问题,或者需要强制刷新,但我们的解决方案中通过watch和设置activeMenu可以避免。 引用[2]:如果使用手动路由,则不需要设置router属性,但需要自己处理跳转。我们这里建议使用router属性自动跳转。 引用[3]:菜单路由的同步问题 -> 通过watch监听路由变化来同步激活菜单。 如果按照以上步骤仍然不能解决,请检查路由配置是否正确,以及是否有其他因素干扰(如权限控制拦截了默认页面的加载)。 相关问题: 1. 如何实现el-menu与浏览器的前进后退操作同步? 2.动态路由中,如何设置el-menu的激活状态? 3. 如何解决el-menu在异步加载菜单数据后的激活状态问题?</think>### 解决 el-menu 默认激活菜单router-view 未显示问题 当 `el-menu` 设置了 `default-active` 但对应的 `router-view` 页面未默认显示时,通常是由于**路由初始化同步问题**导致的。以下是完整的解决方案: #### 核心原因分析 1. **路由初始化时机问题**:菜单激活状态设置早于路由初始化 2. **路由匹配不一致**:`default-active` 的值与路由路径不匹配 3. **嵌套路由未处理**:子路由激活状态未正确传递 4. **异步数据未就绪**:动态路由数据加载延迟导致 #### 完整解决方案 ```html <template> <!-- 方案1:确保路由已初始化 --> <div v-if="routerReady"> <!-- 方案2:正确绑定default-active --> <el-menu :default-active="activeMenu" router @select="handleMenuSelect"> <!-- 方案3:处理嵌套路由 --> <el-submenu index="/parent"> <template #title>父菜单</template> <el-menu-item index="/parent/child">子页面</el-menu-item> </el-submenu> <el-menu-item index="/home">首页</el-menu-item> <el-menu-item index="/result">检测结果</el-menu-item> </el-menu> <!-- 方案4:确保router-view层级正确 --> <router-view :key="$route.fullPath"></router-view> </div> </template> <script> export default { data() { return { routerReady: false, // 路由就绪标志 activeMenu: '' // 激活菜单项 } }, watch: { // 方案5:监听路由变化同步菜单状态 '$route'(to) { this.activeMenu = to.path } }, mounted() { // 方案6:确保路由初始化完成 this.$nextTick(() => { // 设置默认激活菜单(优先使用当前路由) this.activeMenu = this.$route.path || '/home' this.routerReady = true }) }, methods: { // 方案7:手动处理路由跳转(备用) handleMenuSelect(index) { if (this.$route.path !== index) { this.$router.push(index) } } } } </script> ``` #### 关键配置说明 1. **路由初始化同步**(核心) ```javascript mounted() { this.$nextTick(() => { this.activeMenu = this.$route.path || '/default-path' this.routerReady = true // 确保路由就绪后再渲染菜单 }) } ``` 2. **路由匹配规则** - 确保 `default-active` 值 **完全匹配** 路由路径 - 使用 `watch` 同步路由变化: ```javascript watch: { '$route'(to) { this.activeMenu = to.path } } ``` 3. **嵌套路由处理** ```html <!--菜单使用完整路径 --> <el-submenu index="/parent-path"> <!--菜单使用完整路径 --> <el-menu-item index="/parent-path/child-path">子页面</el-menu-item> </el-submenu> ``` 4. **强制刷新路由视图** ```html <!-- 添加key防止组件复用 --> <router-view :key="$route.fullPath"></router-view> ``` 5. **动态路由处理** ```javascript // 如果路由动态生成的 async created() { await this.loadRoutes() // 先加载路由数据 this.activeMenu = this.$route.path } ``` #### 常见问题排查表 | 现象 | 原因 | 解决方案 | |------|------|----------| | 菜单激活但页面不显示 | 路由未初始化 | 使用 `routerReady` 控制渲染时机 | | 刷新后显示正确 | 路由/菜单同步问题 | 添加 `$route` 监听器 | | 嵌套路由不生效 | 路径不匹配 | 使用完整路径作为 index | | 动态路由不生效 | 数据加载顺序问题 | 确保先加载路由再设置 activeMenu | | 浏览器前进/后退不同步 | 未监听路由变化 | 添加 `watch: $route` | #### 路由配置示例 ```javascript // router.js const routes = [ { path: '/', redirect: '/home' // 设置默认重定向 }, { path: '/home', component: HomePage }, { path: '/result', component: ResultPage }, { path: '/parent', component: ParentPage, children: [{ path: 'child', // 完整路径: /parent/child component: ChildPage }] } ] ``` > **关键点**:确保路由配置中的路径与菜单项的 `index` 属性 **完全一致**(包括大小写),这是同步工作的基础[^1][^2][^3]。 通过以上方案,可以解决默认激活菜单对应页面未显示的问题,同时确保通过浏览器前进/后退操作也能正确同步菜单状态。
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值