導航鈎子
(譯者:『導航』表示路由正在發生改變。)
正如其名,vue-router
提供的導航鈎子主要用來攔截導航,讓它完成跳轉或取消。有多種方式可以在路由導航發生時執行鈎子:全局的, 單個路由獨享的, 或者組件級的。
全局鈎子
你可以使用 router.beforeEach
注冊一個全局的 before
鈎子:
const router = new VueRouter({ ... }) router.beforeEach((to, from, next) => { // ... })
當一個導航觸發時,全局的 before
鈎子按照創建順序調用。鈎子是異步解析執行,此時導航在所有鈎子 resolve 完之前一直處於 等待中。
每個鈎子方法接收三個參數:
-
to: Route
: 即將要進入的目標 路由對象 -
from: Route
: 當前導航正要離開的路由 -
next: Function
: 一定要調用該方法來 resolve 這個鈎子。執行效果依賴next
方法的調用參數。-
next()
: 進行管道中的下一個鈎子。如果全部鈎子執行完了,則導航的狀態就是confirmed (確認的)。 -
next(false)
: 中斷當前的導航。如果瀏覽器的 URL 改變了(可能是用戶手動或者瀏覽器后退按鈕),那么 URL 地址會重置到from
路由對應的地址。 -
next('/')
或者next({ path: '/' })
: 跳轉到一個不同的地址。當前的導航被中斷,然后進行一個新的導航。
-
確保要調用 next
方法,否則鈎子就不會被 resolved。
同樣可以注冊一個全局的 after
鈎子,不過它不像 before
鈎子那樣,after
鈎子沒有next
方法,不能改變導航:
router.afterEach(route => {
// ... })
某個路由獨享的鈎子
你可以在路由配置上直接定義 beforeEnter
鈎子:
const router = new VueRouter({ routes: [ { path: '/foo', component: Foo, beforeEnter: (to, from, next) => { // ... } } ] })
這些鈎子與全局 before
鈎子的方法參數是一樣的。
組件內的鈎子
最后,你可以使用 beforeRouteEnter
和 beforeRouteLeave
,在路由組件內直接定義路由導航鈎子,
const Foo = { template: `...`, beforeRouteEnter (to, from, next) { // 在渲染該組件的對應路由被 confirm 前調用 // 不!能!獲取組件實例 `this` // 因為當鈎子執行前,組件實例還沒被創建 }, beforeRouteLeave (to, from, next) { // 導航離開該組件的對應路由時調用 // 可以訪問組件實例 `this` } }
beforeRouteEnter
鈎子 不能 訪問 this
,因為鈎子在導航確認前被調用,因此即將登場的新組件還沒被創建。
不過,你可以通過傳一個回調給 next
來訪問組件實例。在導航被確認的時候執行回調,並且把組件實例作為回調方法的參數。
beforeRouteEnter (to, from, next) { next(vm => { // 通過 `vm` 訪問組件實例 }) }
你可以 在 beforeRouteLeave
中直接訪問 this
。這個 leave
鈎子通常用來禁止用戶在還未保存修改前突然離開。可以通過 next(false)
來取消導航。
在做項目的時候,需求是在關閉頁面的時候給客戶彈出一個框,增加客戶停留的時間。 最近看了一下這個鈎子,覺得很不錯。