vue+iview 动态路由和权限验证
github 上关于 vue 动态添加路由的例子很多，本项目参考了部分项目后，在 iview 框架基础上完成了动态路由的动态添加和菜单刷新。为了帮助其他需要的朋友，现分享出实现逻辑，欢迎一起交流学习。
Github 地址
实现目标
客户端从服务端拿到路由和权限数据后，刷新项目的路由和菜单列表，并进行权限控制。
项目基础
- 基础框架： iview 组件库官方模板项目
iview-admin的 template 分支项目，此项目为iview-admin的基础框架代码。项目地址:iview-admin - 权限验证： 权限验证参考了Vue + ElementUI 手撸后台管理网站基本框架 (二) 权限控制中实现思路和部分代码。
实现逻辑
动态路由控制加载
一般来说，动态路由控制分为两种：一种是将所有路由数据存储在本地文件中，然后从服务端获取用户的权限信息，在路由跳转时，添加权限判断钩子，如果用户前往的页面不在权限列表内，则禁止跳转。另一种则是本地只存储基本路由，如错误处理页面、无权限控制页面等，而权限路由则从服务器获取，服务器根据用户的权限下发相应的路由数据，客户端利用这些数据进行路由的动态生成和添加，本文采用的是第二种方法。
iview-admin 项目将路由分为三种：
- 不作为 Main 组件的子页面展示的页面路由，例如 login、404、403 等错误页面路由；
- 作为 Main 组件的子页面展示但是不在左侧菜单显示的路由
otherRouter，比如首页路由； - 作为 Main 组件的子页面展示并且在左侧菜单显示的路由
appRouter;
拿到路由数据后，我们主要进行两部分操作，第一部分是遍历数据，利用组件异步加载的方法，加载每个路由节点对应的组件，之后利用router.addRoutes(routes)完成路由列表的动态添加；第二部分是因为iview-admin框架下的页面标签和面包屑导航，需要遍历 appRouter 获取路由信息，所以我们也需要将路由数据存入vuex，以便全局访问。
需要特别注意的是，如果 404 页面为静态路由，那么第一次进入页面时，这时动态路由还未加载，找不到路由地址会默认跳转到 404 错误页，体验很差，所以 404 路由先不写入路由规则中，和动态路由一起加载。
主要代码实现如下：
数据请求及路由节点生成
//util.js
// 生成路由
util.initRouter = function (vm) {
const constRoutes = [];
const otherRoutes = [];
<span class="hljs-comment">// 404路由需要和动态路由一起注入</span>
<span class="hljs-keyword">const</span> otherRouter = [{
<span class="hljs-attr">path</span>: <span class="hljs-string">'/*'</span>,
<span class="hljs-attr">name</span>: <span class="hljs-string">'error-404'</span>,
<span class="hljs-attr">meta</span>: {
<span class="hljs-attr">title</span>: <span class="hljs-string">'404-页面不存在'</span>
},
<span class="hljs-attr">component</span>: <span class="hljs-string">'error-page/404'</span>
}];
<span class="hljs-comment">// 模拟异步请求</span>
util.<span class="hljs-title function_">ajax</span>(<span class="hljs-string">'menu.json'</span>).<span class="hljs-title function_">then</span>(<span class="hljs-function"><span class="hljs-params">res</span> =></span> {
<span class="hljs-keyword">var</span> menuData = res.<span class="hljs-property">data</span>;
util.<span class="hljs-title function_">initRouterNode</span>(constRoutes, menuData);
util.<span class="hljs-title function_">initRouterNode</span>(otherRoutes, otherRouter);
<span class="hljs-comment">// 添加主界面路由</span>
vm.<span class="hljs-property">$store</span>.<span class="hljs-title function_">commit</span>(<span class="hljs-string">'updateAppRouter'</span>, constRoutes.<span class="hljs-title function_">filter</span>(<span class="hljs-function"><span class="hljs-params">item</span> =></span> item.<span class="hljs-property">children</span>.<span class="hljs-property">length</span> > <span class="hljs-number">0</span>));
<span class="hljs-comment">// 添加全局路由</span>
vm.<span class="hljs-property">$store</span>.<span class="hljs-title function_">commit</span>(<span class="hljs-string">'updateDefaultRouter'</span>, otherRoutes);
<span class="hljs-comment">// 刷新界面菜单</span>
vm.<span class="hljs-property">$store</span>.<span class="hljs-title function_">commit</span>(<span class="hljs-string">'updateMenulist'</span>, constRoutes.<span class="hljs-title function_">filter</span>(<span class="hljs-function"><span class="hljs-params">item</span> =></span> item.<span class="hljs-property">children</span>.<span class="hljs-property">length</span> > <span class="hljs-number">0</span>));
});
};
// 生成路由节点
util.initRouterNode = function (routers, data) {
for (var item of data) {
let menu = Object.assign({}, item);
menu.component = lazyLoading(menu.component);
<span class="hljs-keyword">if</span> (item.<span class="hljs-property">children</span> && item.<span class="hljs-property">children</span>.<span class="hljs-property">length</span> > <span class="hljs-number">0</span>) {
menu.<span class="hljs-property">children</span> = [];
util.<span class="hljs-title function_">initRouterNode</span>(menu.<span class="hljs-property">children</span>, item.<span class="hljs-property">children</span>);
}
<span class="hljs-comment">//添加权限判断</span>
meta.<span class="hljs-property">permission</span> = menu.<span class="hljs-property">permission</span> ? menu.<span class="hljs-property">permission</span> : <span class="hljs-literal">null</span>;
<span class="hljs-comment">//添加标题</span>
meta.<span class="hljs-property">title</span> = menu.<span class="hljs-property">title</span> ? menu.<span class="hljs-property">title</span> : <span class="hljs-literal">null</span>;
menu.<span class="hljs-property">meta</span> = meta;
}
};
动态加载组件
//lazyLoading.js
export default (url) =>()=>import(@/views/<span class="hljs-subst">${url}</span>.vue)
Store 缓存实现
//app.js
// 动态添加主界面路由，需要缓存
updateAppRouter (state, routes) {
state.routers.push(...routes);
router.addRoutes(routes);
},
// 动态添加全局路由，不需要缓存
updateDefaultRouter (state, routes) {
router.addRoutes(routes);
},
// 接受前台数组，刷新菜单
updateMenulist (state, routes) {
state.menuList = routes;
}
最后在 main.js 中进行调用
//main.js
mounted () {
// 调用方法，动态生成路由
util.initRouter(this);
}
权限控制
同动态路由实现方法类似，操作权限控制也一般也分为两种，第一种是页面显示时不控制权限，所有的操作，比如按钮全部展现，然后在操作发起时，进行权限判断，如果用户拥有该操作的权限，则通过，否则提醒用户无权限，第二种则是在页面加载的时候，就进行权限判断，无权限的操作不进行显示。本人更喜欢第二种方法，这样不会对用户进行误导，个人认为用户看到的应该就行可操作的，不然点下按钮再提示无权限的感觉一定很不爽。
本项目的思路来源见参考博文，原博主的具体思路是：在路由结构的 meta 字段中，添加用户操作权限列表，然后注册全局指令，当节点初次渲染时，判断该页面是否存在权限，如果存在，并且传入的参数不在权限列表中，则直接删除该节点。
主要代码实现如下：
在路由数据中添加permission字段，存放权限列表
//menu.json，模拟异步请求数据
[
{
"path": "/groupOne",
"icon": "ios-folder",
"name": "system_index",
"title": "groupOne",
"component": "Main",
"children": [
{
"path": "pageOne",
"icon": "ios-paper-outline",
"name": "pageOne",
"title": "pageOne",
"component": "group/page1/page1",
"permission":["del"]
},
...
]
}
]
在遍历生成路由节点时，将permission字段数据存入路由节点meta属性中
//util.js
// 生成路由节点
util.initRouterNode = function (routers, data) {
for (var item of data) {
....
// 添加权限判断
meta.permission = menu.permission ? menu.permission : null;
...
}
};
定义全局命令组件，读取路由permission属性值获得权限列表，如果该不权限在权限列表中，则删除节点
//hasPermission.js
const hasPermission = {
install (Vue, options) {
Vue.directive('hasPermission', {
bind (el, binding, vnode) {
let permissionList = vnode.context.$route.meta.permission;
if (permissionList && permissionList.length && !permissionList.includes(binding.value)) {
el.parentNode.removeChild(el);
}
}
});
}
};
export default hasPermission;
权限组件使用示例：
<template>
<div>
<h1>page1</h1>
<Button v-hasPermission="'add'">添加</Button>
<Button v-hasPermission="'edit'">修改</Button>
<Button v-hasPermission="'del'">删除</Button>
</div>
</template>
全局注册组件
// main.js
import hasPermission from '@/libs/hasPermission.js';
Vue.use(hasPermission);
这种权限控制方法的优点就是，不管是管理配置还是页面处理逻辑都相对简单，没有很多重复的代码判断和节点处理，在参考对比了网上几种实现方式后，个人比较推荐这一种方法。
页面标签和面包屑导航
在我看来，页面标签和面包屑都属于系统中锦上添花的页面相关控件，提高页面管理的便捷性，在 iview 官方 admin 项目中已经实现了这两个组件。所以这个项目中，只是将其进行移植，实现了组件功能，没有深入了解，感兴趣的可以仔细研究。
与我联系
Email:thezhangwen@outlook.com