详解vue-router的导航钩子(导航守卫)
在做vue项目的时候,要求用户在页面访问前先登录,或在离开页面前发出提醒。vue官方提供的路由管理器vue-router提供的导航钩子,通过跳转或取消的方式守卫导航。以下总结了路由钩子函数的使用方法和一些使用场景。
一、全局守卫
router.beforeEach路由改变前的钩子
constrouter=newVueRouter({...}) router.beforeEach((to,from,next)=>{ ...... })
其中:
- to:将要访问的路径
- from:代表从哪个路径跳转来的
- next:是一个函数,表示放行。有如下几种调用方式
- next():如果一起正常,则调用该方法进入下一个钩子;
- next(false):中断当前导航,即路由地址不发生变化;
- next('/xxx')或next({path:'/xxx'}):强制跳转到指定路径;
- next(error):如果传入的是一个Error实例,则导航会被中断且该错误会被传递给router.onError()注册过的回调。
使用:
使用该函数,一定要调用next(),否则钩子函数不能resolve;
该方法比较常用于:验证用户访问权限。
比如:一个系统需要先验证用户是否登录,如果登录了就可以访问,否则直接跳转到登录页面。具体实现如下:
importVuefrom'vue' importVueRouterfrom'vue-router' import{getToken}from'@Utils/session.utils'//登录用户的token importLoginfrom'../pages/Login.vue'//引入登录页 constHome=()=>import('../pages/Home.vue')//引入首页 Vue.use(VueRouter)//全局注入router //配置路由参数 constroutes=[ {path:'/login',name:'login',component:Login}, {path:'/home',name:'home',component:Home} ] constrouter=newVueRouter({ routes }) //全局挂载路由导航守卫:验证用户是否登录 router.beforeEach((to,from,next)=>{ if(to.name!=='login'&&!getToken())next('/login')//如果用户不是访问登录页且没有登录,则强制跳转到登录页 elsenext() }) exportdefaultrouter
router.beforeResolve在导航被确认之前,同时在所有组件内守卫和异步路由组件被解析之后,该钩子函数就被调用。
该方法我在项目中暂时还未使用到,具体使用场景欢迎大家补充:)
router.afterEach路由改变后的钩子
router.afterEach((to,from)=>{ ...... })
该方法同全局前置守卫router.beforeEach不同的是少了next()函数,也不会改变导航本身。
使用场景:
路由切换,将页面的滚动位置返回到顶部。
例如:一个页面比较长,当滚动到某个位置后切换路由,这时跳转的页面滚动条位置默认是前一个页面离开时停留的位置,可以通过该钩子函数将滚动条位置重置。
//切换路由,页面返回到顶部 router.afterEach((to,from)=>{ window.scrollTo(0,0) })
二、路由独享的守卫
beforeEnter对某个路由的单独守卫,在路由配置上直接定义
constroutes=[ {path:'/login',name:'login',component:Login}, { path:'/home', name:'home', component:Home, beforeEnter:(to,from,next)=>{ ...... } } ] constrouter=newVueRouter({ routes })
使用:
该方法的参数使用同全局前置守卫router.beforeEach是一样的;
例如:根据登录用户的不同角色,展示不同的模块;或者给指定路由组件单独添加动画。
importVuefrom'vue' importVueRouterfrom'vue-router' import{getUserRole}from'@Utils/session.utils'//登录用户的角色 constUserCenter=()=>import('../pages/UserCenter.vue') constroutes=[ ...... { path:'/usercenter', name:'usercenter', component:UserCenter, beforeEnter:(to,from,next)=>{ if(getUserRole()==='admin')next('/admincenter') elsenext() } } ]
三、组件内的守卫
beforeRouteEnter(to,from,next)在进入当前组件对应的路由前调用
exportdefault{ data(){...}, beforeRouteEnter(to,from,next){ ...... } }
注意:
该函数内不能访问当前组件实例this,因为函数在对应路由被comfirm前调用,此时将要渲染的组件实例还没被创建;
可以通过给next传递一个回调来访问组件实例,即把组件实例vm作为回调方法的参数;该回调的执行在mounted后面;
beforeRouteEnter(to,from,next){ next(vm=>{ //通过vm来访问组件实例 }) }
beforeRouteEnter是支持给next传递回调的唯一守卫。
使用场景:
例如:从一个列表页进入到详情页,然后再返回到列表页,要求保留离开列表页之前访问的数据及滚动位置,从其他页面重新进入列表页,获取最新的数据。具体实现请点这里
beforeRouteUpdate(to,from,next)在当前路由改变,但是该组件被复用时调用
beforeRouteUpdate(to,from,next){ ...... }
注:
该函数内可以访问当前组件实例this
例如:在一个带有动态参数的路径/detail/:id,在/detail/aaa和/detail/bbb之间跳转的时候,因为两个路由渲染的是同个Detail组件,因此原来的组件实例会被复用(比起销毁再创建,复用则会更加高效),在这种情况下这个钩子会被调用,而组件的生命周期钩子不会再被调用。
beforeRouteLeave(to,from,next)在离开当前组件对应的路由前调用
beforeRouteLeave(to,from,next){ ...... }
注:
- 该函数内可以访问当前组件实例this;
- 比如:用户在当前页面有还未保存的内容时突然离开,阻止页面跳转并给出提示,或者在用户离开时清除或存储一些信息等。
四、完整的导航解析流程
- 导航被触发;
- 在失活的组件里调用beforeRouteLeave守卫;
- 调用全局的beforeEach守卫;
- 在重用的组件里调用beforeRouteUpdate守卫(2.2+);
- 在路由配置里调用beforeEnter;
- 解析异步路由组件;
- 在被激活的组件里调用beforeRouteEnter;
- 调用全局的beforeResolve守卫(2.5+);
- 导航被确认;
- 调用全局的afterEach钩子;
- 触发DOM更新;
- 调用beforeRouteEnter守卫中传给next的回调函数,创建好的组件实例会作为回调函数的参数传入。
其实常用的也就那么几个,理解了其用法,路由导航的解析流程也就明了了。
五、附:使用watch监测路由变化
除了使用钩子函数外,我们也可以使用watch来监听$route对象,然后根据路由参数的变化来进行响应。
到此这篇关于详解vue-router的导航钩子(导航守卫)的文章就介绍到这了,更多相关vue-router导航钩子内容请搜索毛票票以前的文章或继续浏览下面的相关文章希望大家以后多多支持毛票票!
声明:本文内容来源于网络,版权归原作者所有,内容由互联网用户自发贡献自行上传,本网站不拥有所有权,未作人工编辑处理,也不承担相关法律责任。如果您发现有涉嫌版权的内容,欢迎发送邮件至:czq8825#qq.com(发邮件时,请将#更换为@)进行举报,并提供相关证据,一经查实,本站将立刻删除涉嫌侵权内容。