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

