聊聊element-ui 侧边栏的router问题

element-ui 侧边栏的router

所以就动态获取api里面的path值作为其router就行。注意带上上级路由。用字符串拼接的方式::index="'/home/' 

对二级导航栏,这里的item是 v-for循环上级的item.children(一级导航栏)的项。

element-ui中侧边栏的分析及实现

el-menu 和 el-submenu

1.如果需要实现一个侧边栏,会如何设计?

2.侧边栏的核心是将根据权限过滤后的 router 和 el-menu 组件进行映射,所以 el-menu 和 el-submenu 是理解 sidebar 的基础。

3.el-menu 表示菜单容器组件,如下所示:

  • default-active:当前激活菜单的 index,注意如果存在子菜单,需要填入子菜单 ID
  • unique-opened 是否只保持一个子菜单的展开
  • mode 模式,枚举值,horizontal / vertical 这两种
  • collapse 是否水平折叠收起菜单(仅在 mode 为 vertical 时可用)
  • collapse-transition 是否开启折叠动画
  • @select 点击菜单事件,菜单激活回调 index: 选中菜单项的 index, indexPath: 选中菜单项的 index path
  • @open: sub-menu 展开的回调
  • @close: sub-menu 收起的回调

4.el-submenu,子菜单容器,el-menu 表示整个菜单, el-submenu 表示一个具体菜单,只是该菜单还包括了子菜单。 el-submenu 可以通过定制 slot 的 title 来自定义菜单模式。el-submenu 容器内 default 的 slot 用来存放子菜单,可以包括三种子菜单组件,如下所示:

  • el-menu-item-group:菜单分组,为一组菜单添加一个标题,容器内需要存放 el-menu-item,支持通过 title 的 slot 来定制标题样式
  • el-submenu:支持循环嵌套 el-submenu,可以使得超过两级子组件得以实现
  • el-menu-item:子菜单组件

示例代码,如下所示:


  
    
默认颜色
                                              选项1           选项2                           选项3                                     选项1                                     导航二                             导航三                             导航四            
     
自定义颜色
                                              选项1           选项2                           选项3                                     选项1                                     导航二                             导航三                             导航四            

sidebar 分析

1.sidebar,如下所示:

  • activeMenu:通过 meta.activeMenu 属性,指定路由对应的高亮菜单,meta.activeMenu 需要提供一个合法的路由,否则不能生效。
  • isCollapse:NavBar 中点击按钮,会修改 Cookie 中的 sidebarStatus,从 vuex 取值时会将 sidebarStatus 转为 Boolean,并判断默认是否需要收缩左侧菜单栏
  • showLogo:判断 settings.js 中的配置项是否需要展示 logo
  • variables:从 @style/variables.css 中获取 scss 对象,从而获取样式

2.sidebar,代码实现如下:

3.sidebar 中通过 sidebar -item 实现子菜单,sidebar-item 的 props 是 item 为路由对象,basePath 是路由路径。sidebar-item 的展示逻辑,如下所示:

通过 item.hidden 控制菜单是否展示

通过 hasOneShowingChild(item.children,item) && (!onlyOneChild.children||onlyOneChild.noShowingChildren)&&!item.alwaysShow 逻辑判断 template 菜单是否展示,template 代表单一菜单,如下所示:

  • hasOneShowingChild:判断是否只有一个需要展示的子路由
  • !onlyOneChild.children||onlyOneChild.noShowingChildren: 判断需要展示的子菜单,是否包含 children 属性,如果包含,则说明子菜单可能存在孙子菜单,此时需要再判断 noShowingChildren 属性
  • !item.alwaysShow:判断路由中是否存在 alwaysShow 属性,如何存在,则返回 false,不展示 template 菜单,也就是只要配置了 alwaysShow 属性就会直接进入 el-submenu 组件

4.对于 hasOneShowingChild 方法,children 是 router 对象的 children 属性,item 是 router 对象,代码如下所示:

hasOneShowingChild(children = [], parent) {
  const showingChildren = children.filter(item => {
    // 如果 children 中的路由包含 hidden 属性,则返回 false
    if (item.hidden) {
      return false
    } else {
      // 将子路由赋值给 onlyOneChild,用于只包含一个路由时展示
      this.onlyOneChild = item
      return true
    }
  })
  // 如果过滤后,只包含展示一个路由,则返回 true
  if (showingChildren.length === 1) {
    return true
  }
  // 如果没有子路由需要展示,则将 onlyOneChild 的 push 设置空路由,并添加 noShowingChildren
  if (showingChildren.length === 0) {
    this.onlyOneChild = { ... parent, path: '', noShowingChildren: true }
    return true
  }
  // 返回 false,表示不需要展示子路由,或者超过 需要展示的子路由
  return false
}

5.对于它们之间的关系,如下所示:

如果展示 template 组件,首先会展示 app-link 组件,然后是 el-menu-item,最里面嵌套的是 item 组件。item 组件需要 meta 中包含 title 和 icon 属性,否则将渲染内容为空的 vnode 对象。

如果 template 菜单不展示,则展示 el-submenu 菜单,el-submenu 逻辑中采用了嵌套组件的做法,将 sidebar-item 嵌套在 el-submenu 中

el-submenu 中的 sidebar-item 的区别,第一个是传入 is-nest 参数,第二个是传入 base-path 参数

6.sidebar-item,代码如下所示:

7.app-link,是一个动态组件,通过 to 参数,如果包含 http 前缀则变成一个 a 标签,否则变成一个 router-link 组件。

8.app-link,代码如下所示:

9.item 组件,通过定义的 render 函数完成组件渲染。

10item,代码如下所示:

侧边栏实现总结

1.sidebar 主要包括 el-menu 容器组件,el-menu 中遍历 vuex 中的 routes,生成 sidebar-item 组件。sidebar 主要配置如下所示:

  • activeMenu:根据当前路由的 meta.activeMenu 属性控制侧边栏中高亮菜单
  • isCollapse:根据 Cookie 的 sidebarStatus 控制侧边栏是否折叠
  • variables:通过 @style/variables.css 填充 el-menu 的基本样式

2.sidebar-item,分为两个部分,如下所示:

第一部分是当只需要展示一个 children 或者没有 children 时进行展示,展示的组件包括:

  • app-link:动态组件,path 为链接时,显示为 a 标签,path 为路由时,显示为 router-link 组件
  • el-menu-item:菜单项,当 sidebar-item 为非 nest 组件时,el-menu-item 会增加 submenu-title-noDropdown 的 class
  • item:el-menu-item 里的内容,主要是 icon 和 title,当 title 为空时,整个菜单项将不会展示

第二部分是当 children 超过两项时进行展示,展示的组件包括:

el-submenu:子菜单组件容器,用于嵌套子菜单组件

sidebar-item:el-submen 迭代嵌套了 sidebar-item 组件,在 sidebar-item 组件中的变化,设置了 is-nest 属性为 true,根据 child.path 生成了 base-path 属性传入 sidebar-item 组件

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

你可能感兴趣的:(聊聊element-ui 侧边栏的router问题)