詳解vue-router的導航鉤子(導航守衛(wèi))
在做vue項目的時候,要求用戶在頁面訪問前先登錄,或在離開頁面前發(fā)出提醒。vue官方提供的路由管理器 vue-router 提供的導航鉤子,通過跳轉(zhuǎn)或取消的方式守衛(wèi)導航。以下總結(jié)了路由鉤子函數(shù)的使用方法和一些使用場景。
一、全局守衛(wèi)
router.beforeEach 路由改變前的鉤子
const router = new VueRouter({ ... }) router.beforeEach((to, from, next) => { ... ... })
其中:
- to:將要訪問的路徑
- from:代表從哪個路徑跳轉(zhuǎn)來的
- next:是一個函數(shù),表示放行。有如下幾種調(diào)用方式
- next():如果一起正常,則調(diào)用該方法進入下一個鉤子;
- next(false):中斷當前導航,即路由地址不發(fā)生變化;
- next('/xxx') 或 next({path: '/xxx'}):強制跳轉(zhuǎn)到指定路徑;
- next(error):如果傳入的是一個Error實例,則導航會被中斷且該錯誤會被傳遞給 router.onError() 注冊過的回調(diào)。
使用:
使用該函數(shù),一定要調(diào)用 next(),否則鉤子函數(shù)不能 resolve;
該方法比較常用于:驗證用戶訪問權(quán)限。
比如:一個系統(tǒng)需要先驗證用戶是否登錄,如果登錄了就可以訪問,否則直接跳轉(zhuǎn)到登錄頁面。具體實現(xiàn)如下:
import Vue from 'vue' import VueRouter from 'vue-router' import { getToken } from '@Utils/session.utils' // 登錄用戶的token import Login from '../pages/Login.vue' //引入登錄頁 const Home = () => import('../pages/Home.vue') //引入首頁 Vue.use(VueRouter) // 全局注入router // 配置路由參數(shù) const routes = [ { path: '/login', name: 'login', component: Login }, { path: '/home', name: 'home', component: Home } ] const router = new VueRouter({ routes }) // 全局掛載路由導航守衛(wèi):驗證用戶是否登錄 router.beforeEach((to, from, next) => { if (to.name !== 'login' && !getToken()) next('/login') // 如果用戶不是訪問登錄頁且沒有登錄,則強制跳轉(zhuǎn)到登錄頁 else next() }) export default router
router.beforeResolve 在導航被確認之前,同時在所有組件內(nèi)守衛(wèi)和異步路由組件被解析之后,該鉤子函數(shù)就被調(diào)用。
該方法我在項目中暫時還未使用到,具體使用場景歡迎大家補充 :)
router.afterEach 路由改變后的鉤子
router.afterEach((to, from) => { ... ... })
該方法同全局前置守衛(wèi) router.beforeEach 不同的是少了 next() 函數(shù),也不會改變導航本身。
使用場景:
路由切換,將頁面的滾動位置返回到頂部。
例如:一個頁面比較長,當滾動到某個位置后切換路由,這時跳轉(zhuǎn)的頁面滾動條位置默認是前一個頁面離開時停留的位置,可以通過該鉤子函數(shù)將滾動條位置重置。
// 切換路由,頁面返回到頂部 router.afterEach((to, from) => { window.scrollTo(0, 0) })
二、路由獨享的守衛(wèi)
beforeEnter 對某個路由的單獨守衛(wèi),在路由配置上直接定義
const routes = [ { path: '/login', name: 'login', component: Login }, { path: '/home', name: 'home', component: Home, beforeEnter: (to, from, next) => { ... ... } } ] const router = new VueRouter({ routes })
使用:
該方法的參數(shù)使用同全局前置守衛(wèi) router.beforeEach 是一樣的;
例如:根據(jù)登錄用戶的不同角色,展示不同的模塊;或者給指定路由組件單獨添加動畫。
import Vue from 'vue' import VueRouter from 'vue-router' import { getUserRole } from '@Utils/session.utils' // 登錄用戶的角色 const UserCenter = () => import('../pages/UserCenter.vue') const routes = [ ... ... { path: '/usercenter', name: 'usercenter', component: UserCenter, beforeEnter: (to, from, next) => { if(getUserRole() === 'admin') next('/admincenter') else next() } } ]
三、組件內(nèi)的守衛(wèi)
beforeRouteEnter(to, from, next) 在進入當前組件對應的路由前調(diào)用
export default { data() { ... }, beforeRouteEnter(to, from, next) { ... ... } }
注意:
該函數(shù)內(nèi)不能訪問當前組件實例 this,因為函數(shù)在對應路由被 comfirm 前調(diào)用,此時將要渲染的組件實例還沒被創(chuàng)建;
可以通過給 next 傳遞一個回調(diào)來訪問組件實例,即把組件實例 vm 作為回調(diào)方法的參數(shù);該回調(diào)的執(zhí)行在 mounted 后面;
beforeRouteEnter (to, from, next) { next(vm => { // 通過 vm 來訪問組件實例 }) }
beforeRouteEnter 是支持給 next 傳遞回調(diào)的唯一守衛(wèi)。
使用場景:
例如:從一個列表頁進入到詳情頁,然后再返回到列表頁,要求保留離開列表頁之前訪問的數(shù)據(jù)及滾動位置,從其他頁面重新進入列表頁,獲取最新的數(shù)據(jù)。具體實現(xiàn)請點這里
beforeRouteUpdate(to, from, next) 在當前路由改變,但是該組件被復用時調(diào)用
beforeRouteUpdate (to, from, next) { ... ... }
注:
該函數(shù)內(nèi)可以訪問當前組件實例 this
例如:在一個帶有動態(tài)參數(shù)的路徑 /detail/:id,在 /detail/aaa 和 /detail/bbb 之間跳轉(zhuǎn)的時候,因為兩個路由渲染的是同個 Detail 組件,因此原來的組件實例會被復用(比起銷毀再創(chuàng)建,復用則會更加高效),在這種情況下這個鉤子會被調(diào)用,而組件的生命周期鉤子不會再被調(diào)用。
beforeRouteLeave(to, from, next) 在離開當前組件對應的路由前調(diào)用
beforeRouteLeave (to, from, next) { ... ... }
注:
- 該函數(shù)內(nèi)可以訪問當前組件實例 this;
- 比如:用戶在當前頁面有還未保存的內(nèi)容時突然離開,阻止頁面跳轉(zhuǎn)并給出提示,或者在用戶離開時清除或存儲一些信息等。
四、完整的導航解析流程
- 導航被觸發(fā);
- 在失活的組件里調(diào)用 beforeRouteLeave 守衛(wèi);
- 調(diào)用全局的 beforeEach 守衛(wèi);
- 在重用的組件里調(diào)用 beforeRouteUpdate 守衛(wèi) (2.2+);
- 在路由配置里調(diào)用 beforeEnter;
- 解析異步路由組件;
- 在被激活的組件里調(diào)用 beforeRouteEnter;
- 調(diào)用全局的 beforeResolve 守衛(wèi) (2.5+);
- 導航被確認;
- 調(diào)用全局的 afterEach 鉤子;
- 觸發(fā) DOM 更新;
- 調(diào)用 beforeRouteEnter 守衛(wèi)中傳給 next 的回調(diào)函數(shù),創(chuàng)建好的組件實例會作為回調(diào)函數(shù)的參數(shù)傳入。
其實常用的也就那么幾個,理解了其用法,路由導航的解析流程也就明了了。
五、附:使用 watch 監(jiān)測路由變化
除了使用鉤子函數(shù)外,我們也可以使用 watch 來監(jiān)聽 $route 對象,然后根據(jù)路由參數(shù)的變化來進行響應。
<template> <div id=``"app"``> <keep-alive> <router-view/> </keep-alive> </div> </template> <script> export default { name: 'App', watch: { '$route' (to, from) { // 對路由變化作出響應... } } } </script>
到此這篇關(guān)于詳解vue-router的導航鉤子(導航守衛(wèi))的文章就介紹到這了,更多相關(guān)vue-router 導航鉤子內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
vue-cli?npm如何解決vue項目中缺失core-js的問題
這篇文章主要介紹了vue-cli?npm如何解決vue項目中缺失core-js的問題,具有很好的參考價值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教2022-08-08vue3監(jiān)聽resize窗口事件(離開頁面要銷毀窗口事件)
這篇文章主要給大家介紹了關(guān)于vue3監(jiān)聽resize窗口事件(離開頁面要銷毀窗口事件)的相關(guān)資料,vue是單頁面應用,路由切換后,定時器并不會自動關(guān)閉,需要手動清除,當頁面被銷毀時,清除定時器即可,需要的朋友可以參考下2023-11-11nuxt框架中對vuex進行模塊化設置的實現(xiàn)方法
這篇文章主要介紹了nuxt框架中對vuex進行模塊化設置的實現(xiàn)方法,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧2019-09-09