【vue-router】高阶应用
1.导航守卫
(1)定义
导航守卫(navigation-guards)这个名字,听起来怪怪的,但既然官方文档是这样翻译的,导航守卫可分为全局守卫,路由守卫,和组件内守卫。一个路由导航(或者说路由切换)在所有守卫执行完之前一直处于等待中。
(2)作用
通过一定的条件对路由进行控制,比如通过判断是否存在token决定是跳转到下一个页面还是登录页面。主要是路由跳转前做一些验证,比如登录验证,是网站中的普遍需求。
// 设置路由导航卫士,通过判断是否存在token,对网页访问权限进行设置
router.beforeEach((to, from, next) => {
// to表示将要访问的地址
// from表示从哪个路径跳转而来
// next是放行函数 next()放行 next('/path')强制跳转
if (to.path === '/login') return next()
const tokenStr = window.sessionStorage.getItem('token')
if (!tokenStr) return next('/login')
next()
})
2.全局守卫
重点介绍全局前置守卫,使用 router.beforeEach 注册一个全局前置守卫
const router = new VueRouter({ ... })
router.beforeEach((to, from, next) => {
// ...
})
当一个导航(路由切换)触发时,全局前置守卫被调用。守卫会接收三个参数:to,from,next,参数说明:
(1)to: Route: 即将要进入的目标 路由对象
(2)from: Route: 当前导航正要离开的路由
(3)next: Function: 一定要调用
,执行效果依赖 next 方法的调用参数。
- next():
- next(false): 中断当前的导航。
- next('/') 或者 next({ path: '/' }): 跳转到一个不同的地址。当前的导航被中断,然后进行一个新的导航。
- next(error):如果传入
next
的参数是一个Error
实例,则导航会被终止且该错误会被传递给 [router.onError()
]注册过的回调。
确保 next 函数在任何给定的导航守卫中都被严格调用一次。它可以出现多于一次
,但是只能在所有的逻辑路径都不重叠的情况下,否则钩子永远都不会被解析或报错。
// BAD
router.beforeEach((to, from, next) => {
if (to.name !== 'Login' && !isAuthenticated) next({ name: 'Login' })
// 如果用户未能验证身份,则 `next` 会被调用两次
next()
})
// GOOD
router.beforeEach((to, from, next) => {
if (to.name !== 'Login' && !isAuthenticated) next({ name: 'Login' })
else next()
})
还有全局解析守卫,全局后置钩子全局卫士,不具体详解。
3.路由独享的守卫
在路由配置上直接定义 beforeEnter 守卫
const router = new VueRouter({
routes: [
{
path: '/foo',
component: Foo,
beforeEnter: (to, from, next) => {
// ...
}
}
]
})
4.组件内的守卫
在路由组件内直接定义以下路由导航守卫
const Foo = {
template: `...`,
beforeRouteEnter (to, from, next) {
// 在渲染该组件的对应路由被 confirm 前调用
// 不!能!获取组件实例 `this`
// 因为当守卫执行前,组件实例还没被创建
},
beforeRouteUpdate (to, from, next) {
// 在当前路由改变,但是该组件被复用时调用
// 举例来说,对于一个带有动态参数的路径 /foo/:id,在 /foo/1 和 /foo/2 之间跳转的时候,
// 由于会渲染同样的 Foo 组件,因此组件实例会被复用。而这个钩子就会在这个情况下被调用。
// 可以访问组件实例 `this`
},
beforeRouteLeave (to, from, next) {
// 导航离开该组件的对应路由时调用
// 可以访问组件实例 `this`
}
}
5.导航解析流程
导航被触发。
在失活的组件里调用 beforeRouteLeave 守卫。
调用全局的 beforeEach 守卫。
在重用的组件里调用 beforeRouteUpdate 守卫 (2.2+)。
在路由配置里调用 beforeEnter。
解析异步路由组件。
在被激活的组件里调用 beforeRouteEnter。
调用全局的 beforeResolve 守卫 (2.5+)。
导航被确认。
调用全局的 afterEach 钩子。
触发 DOM 更新。
调用 beforeRouteEnter 守卫中传给 next 的回调函数,创建好的组件实例会作为回调函数的参数传入。