路由和侧边栏
本项目侧边栏和路由是绑定在一起的,所以你只有在 下面配置对应的路由,侧边栏就能动态的生成了。大大减轻了手动重复编辑侧边栏的工作量。当然这样就需要在配置路由的时候遵循一些约定的规则。
首先我们了解一些本项目配置路由时提供了哪些配置项。
示例:
{
path: '/permission',
component: Layout,
redirect: '/permission/index', //重定向地址,在面包屑中点击会重定向去的地址
hidden: true, // 不在侧边栏线上
alwaysShow: true, //一直显示根路由
meta: { roles: ['admin','editor'] }, //你可以在根路由设置权限,这样它下面所以的子路由都继承了这个权限
path: 'index',
component: ()=>import('permission/index'),
name: 'permission',
meta: {
title: 'permission',
icon: 'lock', //图标
role: ['admin','editor'], //或者你可以给每一个子路由设置自己的权限
noCache: true // 不会被 <keep-alive> 缓存
}
}]
}
路由
这里的路由分为两种,constantRouterMap
和 。
constantRouterMap: 代表那些不需要动态判断权限的路由,如登录页、404、等通用页面。
asyncRouterMap: 代表那些需求动态判断权限并通过 addRouters
动态添加的页面。
具体的会在 页面介绍。
TIP
这里所有的路由页面都使用 路由懒加载
了 ,具体介绍见文档
如果你想了解更多关于 browserHistory 和 hashHistory,请参看 。
其它的配置和 vue-router 官方并没有区别,自行查看文档。
注意事项
本项目侧边栏主要基于 element-ui
的 el-menu
改造。
前面也介绍了,侧边栏是通过读取路由并结合权限判断而动态生成的,而且还需要支持路由无限嵌套,所以这里还使用到了递归组件。
代码地址
这里同时也改造了 element-ui
默认侧边栏不少的样式,所有的 css 都可以在 @/styles/sidebar.scss 中找到,你也可以根据自己的需求进行修改。
这里需要注意一下,一般侧边栏有两种形式即:submenu
和 直接 el-menu-item
。 一个是嵌套子菜单,另一个则是直接一个链接。如下图:
在 Sidebar
中已经帮你做了判断,当你一个路由下面的 children
声明的路由大于>1 个时,自动会变成嵌套的模式。如果子路由正好等于一个就会默认将子路由作为根路由显示在侧边栏中,若不想这样,可以通过设置在根路由中设置alwaysShow: true
来取消这一特性。如:
点击侧边栏 刷新当前路由
在用 spa(单页面应用) 这种开发模式的之前,用户每次点击侧边栏都会重新请求这个页面,用户渐渐养成了点击侧边栏当前路由来刷新 view 的习惯。但现在 spa 就不一样了,用户点击当前高亮的路由并不会刷新 view,因为 vue-router 会拦截你的路由,它判断你的 url 并没有任何变化,所以它不会触发任何钩子或者是 view 的变化。 地址,社区也对该问题展开了激烈讨论。
尤大本来也说要增加一个方法来强刷 view,但后来他又改变了心意/(ㄒ o ㄒ)/~~。但需求就摆在这里,我们该怎么办呢?他说了不改变 current URL 就不会触发任何东西,那我可不可以强行触发你的 hook 呢?上有政策, 下有对策我们变着花来 hack。方法也很简单,通过不断改变 url 的 query 来触发 view 的变化。我们监听侧边栏每个 link 的 click 事件,每次点击都给 router push 一个不一样的 query 来确保会重新刷新 view。
clickLink(path) {
this.$router.push({
path,
t: +new Date() //保证每次点击路由的query项都是不一样的,确保会重新刷新view
}
})
ps:不要忘了在 router-view
加上一个特定唯一的 key
,如 <router-view :key="$route.path"></router-view>
,但这也有一个弊端就是 url 后面有一个很难看的 query
后缀如 xxx.com/article/list?t=1496832345025
本项目中也封装了一个面包屑导航,它也是通过 watch $route
变化动态生成的。它和 menu 也一样,也可以通过之前那些配置项控制一些路由在面包屑中的展现。大家也可以结合自己的业务需求增改这些自定义属性。
代码地址
侧边栏滚动问题
之前版本的滚动都是用 css 来做处理的
首先这样写会有兼容性问题,在火狐或者其它低版本浏览器中都会比较不美观。其次在侧边栏收起的情况下,受限于 element-ui
的 menu
组件的实现方式,不能使用该方式来处理。
所以现版本中使用了 el-scrollbar
来处理侧边栏滚动问题。
代码地址
你也可以在侧边栏中配置一个外链,只要你在 path
中填写了合法的 url 路径,当你点击侧边栏的时候就会帮你新开这个页面。
例如:
{
"path": "external-link",
"component": Layout,
"children": [
{
"path": "https://github.com/PanJiaChen/vue-element-admin",
"meta": { "title": "externalLink", "icon": "link" }
}
]
}