这是我参与「第五届青训营 」伴学笔记创作活动的第 5 天
为什么使用导航守卫?
我们来考虑一个需求: 在一个SPA应用中, 如何改变网页的标题呢? 网页标题是通过来显示的, 但是SPA只有一个固定的HTML, 切换不同的页面时, 标题并不会改变. 但是我们可以通过JavaScript来修改的内容.window.document.title = '新的标题'.
那么在Vue项目中, 在哪里修改? 什么时候修改比较合适呢? 普通的修改方式: 我们比较容易想到的修改标题的位置是每一个路由对应的组件.vue文件中. 通过mounted声明周期函数, 执行对应的代码进行修改即可.
生命周期函数 组件被创建出来 后回调created函数 模板挂载到DOM上 后回调mounted函数 界面发生一次刷新 就调用一次updated函数
但是当页面比较多时, 这种方式不容易维护(因为需要在多个页面执行类似的代码).
export default {
name : "Home",
// created () {
// console.log("crested");
// document.title = "首页"
// }
};
有没有更好的办法呢? 使用导航守卫即可.
监听网页跳转过程
什么是导航守卫?
vue-router提供的导航守卫主要用来监听监听路由的进入和离开的.
vue-router提供了beforeEach和afterEach的钩子函数, 它们会在路由即将改变前和改变后触发.
导航守卫使用
我们可以利用beforeEach来完成标题的修改. 首先, 我们可以在钩子当中定义一些标题, 可以利用meta来定义 (meta:元数据--描述数据的数据) 其次, 利用导航守卫,修改我们的标题.
导航钩子的三个参数解析: to: 即将要进入的目标的路由对象. from: 当前导航即将要离开的路由对象. next: 调用该方法后, 才能进入下一个钩子. 必须写
next: Function :一定要调用该方法来resolve这个钩子。执行效果依赖next方法的调用参数。
- next(): 进行管道中的下一个钩子。如果全部钩子执行完了,则导航的状态就是confirmed (确认的)。
- next(false): 中断当前的导航。如果浏览器的URL改变了(可能是用户手动或者浏览器后退按钮),那么URL地址会重置到from路由对应的地址。
- next("/")或者next({ path: '/'}): 跳转到一个不同的地址。当前的导航被中断,然后进行一个新的导航。你可以向next传递任意位置对象,且允许设置诸如replace: true,name :'home'之类的选项以及任何用在router-link的 to prop或router.push中的选项。
- next(error): (2.4.0+)如果传入next的参数是一个Error实例,则导航会被终止且该错误会被传递给router.onError()注册过的回调。 确保要调next方法,否则钩子就不会被resolved。
{
path : '/profile',
component : Profile,
meta : {
title : '档案'
}
}
// 前置守卫guard 表示回调
router.beforeEach((to, from, next) =>{
// 从from跳转到to
// matched:用于嵌套路由,第一个元素为最外层的大标题
document.title = to.matched[0].meta.title
console.log("++++");
next()
})
// 后置钩子hook
router.afterEach((to, from) => {
console.log("----");
})
导航守卫补充
补充一: 如果是后置钩子, 也就是afterEach, 不需要主动调用next()函数.
补充二: 上面我们使用的导航守卫, 被称之为全局守卫(只要进行路由跳转,就会执行 路由独享的守卫.(只有进入某个路由才会回调,可以在路由配置上直接定义beforeEnter守卫 组件内的守卫.
更多内容, 可以查看官网进行学习: router.vuejs.org/zh/guide/ad…
// 你可以在路由配置上直接定义beforeEnter守卫:
// 这些守卫与全局前置守卫的方法参数是一样的。
const router = new VueRouter({
routes:[
{
path: "/foo" ,
component: Foo,
beforeEnter: (to,from,next)=>{
...
}
}]
})
// 最后,你可以在路由组件内直接定义以下路由导航守卫:
// beforeRouteEnter
// beforeRouteUpdate (2.2新增)
// beforeRouteLeave
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'
}
}