el-menu导航菜单的二次封装(递归组件)实现动态多级菜单

本文涉及的产品
云数据库 RDS MySQL,集群系列 2核4GB
推荐场景:
搭建个人博客
云数据库 Tair(兼容Redis),内存型 2GB
Redis 开源版,标准版 2GB
推荐场景:
搭建游戏排行榜
简介: el-menu导航菜单的二次封装(递归组件)实现动态多级菜单

问题描述

在后台管理项目中,牵涉到权限的东西多数是后端传递过来的数据,前端去展示(当然前端也会做一些控制)。就导航菜单而言,也不能写死了,需要在用户登录了以后,发请求获取用户的对应菜单数据,根据对应的数据去展示对应的菜单。

本文记录一下使用组件递归的方式,封装一个动态的、多级的导航菜单,从而实现动态效果。

看这篇文章之前,可以看看我之前的《vue组件的递归自调用~代码思路分析》文章,本篇文章是之前文章的延伸。地址如下: https://juejin.cn/post/7014130015902105636

效果图

我们先看一下效果图:

22.gif

思路分析

  • 首先,我们要和后端沟通返回的数据格式,我们知道前端的el-menu菜单的核心数据属性有四个:

    • 菜单的名字name
    • 点击菜单进行路由跳转的路径path
    • 菜单上小图标icon
    • 菜单是不是最内层的菜单,即children是否是空数组,当children为空的时候,就说明到菜单最里层了。(最里层的菜单children为空数组的时候,点击的时候,做路由跳转)
  • 所以需要有name、path、icon、children属性,且得是一个树结构的格式,和左侧导航菜单保持一致。
  • 这里我们模拟一下后端返回的代码

后端返回的el-menu菜单数据

menuArr: [
    {
// 注意!注意!有children的菜单项,path不会使用的,所以path为什么都无所谓;没children的,即children的length等于0的,才会使用path属性做路由跳转
      name: "前端三大框架",
      path: "前端三大框架", 
      icon: "el-icon-star-off",
      children: [
        {
          name: "vue页面",
          path: "/vue",
          icon: "el-icon-star-off",
          children: [],
        },
        {
          name: "react页面",
          path: "/react",
          icon: "el-icon-star-off",
          children: [],
        },
        {
          name: "angular页面",
          path: "/angular",
          icon: "el-icon-star-off",
          children: [],
        },
      ],
    },
    {
      name: "后端两大框架",
      path: "后端两大框架",
      icon: "el-icon-star-off",
      children: [
        {
          name: "Spring Boot页面",
          path: "/springBoot",
          icon: "el-icon-star-off",
          children: [],
        },
        {
          name: "Spring页面",
          path: "Spring页面", 
          icon: "el-icon-star-off",
          children: [
            {
              name: "MySql页面",
              path: "/mysql",
              icon: "el-icon-star-off",
              children: [],
            },
            {
              name: "Redis页面",
              path: "/redis",
              icon: "el-icon-star-off",
              children: [],
            },
          ],
        },
        {
          name: "Mybatis页面",
          path: "/mybatis",
          icon: "el-icon-star-off",
          children: [],
        },
      ],
    },
  ]
我们先看一下非动态多级菜单的写法,然后再看一下递归组件动态多级菜单的写法

非动态多级菜单(写死了,不灵活,不建议使用)

<el-menu
  :default-active="activeIndex"
  class="elMenu"
  background-color="#333"
  text-color="#B0B0B2"
  active-text-color="#fff"
  :unique-opened="true"
  router
  ref="elMenu"
  @select="menuSelect"
>

  <el-submenu index="非叶子节点也需要index属性">
    <template slot="title">
      <i class="el-icon-star-off"></i>
      <span>前端三大框架</span>
    </template>
    <!-- 这个是没子节点的 没有子内容,用el-menu-item结构 -->
    <el-menu-item index="/vue">
      <i class="el-icon-star-off"></i>
      <span slot="title">vue页面</span>
    </el-menu-item>
    <el-menu-item index="/react">
      <i class="el-icon-star-off"></i>
      <span slot="title">react页面</span>
    </el-menu-item>
    <el-menu-item index="/angular">
      <i class="el-icon-pear"></i>
      <span slot="title">angular页面</span>
    </el-menu-item>
  </el-submenu>
  
  <el-submenu index="非叶子节点也需要index属性哦">
    <template slot="title">
      <i class="el-icon-star-off"></i>
      <span>后端两大框架</span>
    </template>
    <el-menu-item index="/springBoot">
      <i class="el-icon-star-off"></i>
      <span slot="title">Spring Boot页面</span>
    </el-menu-item>

      <!-- 注意看这里有子节点的无子节点的html标签的区别 -->

      <!-- 这个是有子节点的 还有子内容,用el-submenu结构-->
      <el-submenu index="非叶子节点也需要index属性哈">
          <template slot="title">
            <i class="el-icon-star-off"></i>
            <span>Spring页面</span>
          </template>
          <el-menu-item index="/mysql">
            <i class="el-icon-star-off"></i>
            <span slot="title">MySql页面</span>
          </el-menu-item>
          <el-menu-item index="/redis">
            <i class="el-icon-star-off"></i>
            <span slot="title">Redis页面</span>
          </el-menu-item>
      </el-submenu>

      <!-- 这个是没子节点的 没有子内容,用el-menu-item结构 -->
      <el-menu-item index="/mybatis">
          <i class="el-icon-star-off"></i>
          <span slot="title">Mybatis页面</span>
      </el-menu-item>

  </el-submenu>
</el-menu>

发现规律

通过上述代码,我们发现,el-menu代码大致分为两类,有子集和没有子集的

  • 有子集:用的是el-submenu标签包template标签指定名字跟很多个el-menu-item标签
  • 没子集:直接用很多个el-menu-item标签
得出上述规律,我们就能使用递归组件方式去封装一个动态菜单

动态菜单代码

外层菜单部分

html部分

<el-menu
  :default-active="activeIndex"
  class="elMenu"
  background-color="#333"
  text-color="#B0B0B2"
  active-text-color="#fff"
  :unique-opened="true"
  router
  ref="elMenu"
  @select="menuSelect"
>

  <!-- 递归动态菜单 -->
  <myitem :data="menuArr"></myitem>

</el-menu>

js部分

import myitem from "./components/myitem.vue"; // 引入递归菜单组件
export default {
  name: "Home",
  components: {
    myitem, // 注册一下
  },
  data() {
    return {
      activeIndex: this.$route.path,
      menuArr: [...] // 数据是上述我们模拟的数据,#后端返回的el-menu菜单数据#
    };
  }
};

内层递归菜单项部分

<template>
  <div>
    <template v-for="(item, index) in data">
      <!-- 因为有子集和无子集渲染html标签不一样,所以要分为两种情况
           情况一:有子集的情况:                         -->
      <el-submenu
        :key="index"
        :index="item.path"
        v-if="item.children.length > 0"
      >
        <template slot="title">
          <i :class="item.icon"></i>
          <span>{{ item.name }}</span>
        </template>
        <myitem :data="item.children"></myitem>
      </el-submenu>
      <!-- 情况二:没子集的情况: -->
      <el-menu-item :key="index" v-else :index="item.path">
        <i :class="item.icon"></i>
        <span slot="title">{{ item.name }}</span>
      </el-menu-item>
    </template>
  </div>
</template>

<script>
export default {
  name: "myitem",
  props: {
    data: {
      type: Array,
      default: [],
    },
  },
  // 注意: 在template标签上使用v-for,:key="index"不能写在template标签上,因为其标签不会被渲染,会引起循环错误
};
</script>

完整代码

完整代码我上传到Gitee上去了,欢迎大家下载查看,这样更加方便理解。

地址:https://gitee.com/ah-shuai/dynamic-menu

相关实践学习
基于Redis实现在线游戏积分排行榜
本场景将介绍如何基于Redis数据库实现在线游戏中的游戏玩家积分排行榜功能。
云数据库 Redis 版使用教程
云数据库Redis版是兼容Redis协议标准的、提供持久化的内存数据库服务,基于高可靠双机热备架构及可无缝扩展的集群架构,满足高读写性能场景及容量需弹性变配的业务需求。 产品详情:https://www.aliyun.com/product/kvstore &nbsp; &nbsp; ------------------------------------------------------------------------- 阿里云数据库体验:数据库上云实战 开发者云会免费提供一台带自建MySQL的源数据库&nbsp;ECS 实例和一台目标数据库&nbsp;RDS实例。跟着指引,您可以一步步实现将ECS自建数据库迁移到目标数据库RDS。 点击下方链接,领取免费ECS&amp;RDS资源,30分钟完成数据库上云实战!https://developer.aliyun.com/adc/scenario/51eefbd1894e42f6bb9acacadd3f9121?spm=a2c6h.13788135.J_3257954370.9.4ba85f24utseFl
相关文章
|
JavaScript
Layui 弹层组件 - 基础参数3
Layui 弹层组件 - 基础参数3
73 0
|
JavaScript 前端开发
Layui 弹层组件 - 基础参数1
Layui 弹层组件 - 基础参数1
95 0
|
数据库
Layui入门&动态树&动态选项卡&用户增加&修改&删除&(一)
Layui入门&动态树&动态选项卡&用户增加&修改&删除&
|
4月前
|
JavaScript
vue实战--v-for 遍历渲染按钮的两种实现方案(重点:按钮点击事件的绑定技巧)
vue实战--v-for 遍历渲染按钮的两种实现方案(重点:按钮点击事件的绑定技巧)
75 1
|
6月前
Vue3组件库 -- element plus 树形选择器组件怎样显示已有的树形菜单?
Vue3组件库 -- element plus 树形选择器组件怎样显示已有的树形菜单?
96 0
|
JavaScript 索引
Layui 弹层组件 - 基础参数5
Layui 弹层组件 - 基础参数5
193 0
|
JavaScript
Layui 弹层组件 - 基础参数4
Layui 弹层组件 - 基础参数4
74 0
Layui 弹层组件 - 基础参数2
Layui 弹层组件 - 基础参数2
63 0
Layui入门&动态树&动态选项卡&用户增加&修改&删除&(二)
Layui入门&动态树&动态选项卡&用户增加&修改&删除&
|
前端开发
【el-tree】树形组件图标的自定义
【el-tree】树形组件图标的自定义
1585 0