Vue Router被我們忽略的知識點

蝸牛的北極星之旅發表於2019-12-16

總結回顧

1、設定多段“路徑引數”

Vue Router被我們忽略的知識點

2、響應路由引數變化

針對複用元件(只是路由引數發生改變),生命週期函式鉤子不會被呼叫。

watch: {
    '$route' (to, from) {
      // 對路由變化作出響應...
    }
  }
複製程式碼
beforeRouteUpdate (to, from, next) {
    // react to route changes...
    // don't forget to call next()
  }
複製程式碼

3、路由匹配

{
  // 會匹配所有路徑
  path: '*'
}
{
  // 會匹配以 `/user-` 開頭的任意路徑
  path: '/user-*'
}
複製程式碼

當使用萬用字元路由時,請確保路由的順序是正確的,也就是說含有萬用字元的路由應該放在最後。路由 { path: '*' } 通常用於客戶端 404 錯誤。如果你使用了History 模式,請確保正確配置你的伺服器。 當使用一個萬用字元時,$route.params 內會自動新增一個名為 pathMatch 引數。它包含了 URL 通過萬用字元被匹配的部分:

// 給出一個路由 { path: '/user-*' }
this.$router.push('/user-admin')
this.$route.params.pathMatch // 'admin'
// 給出一個路由 { path: '*' }
this.$router.push('/non-existing')
this.$route.params.pathMatch // '/non-existing'
複製程式碼

4、高階匹配模式

// 命名引數必須有"單個字元"[A-Za-z09]組成

// ?可選引數
{ path: '/optional-params/:foo?' }
// 路由跳轉是可以設定或者不設定foo引數,可選
<router-link to="/optional-params">/optional-params</router-link>
<router-link to="/optional-params/foo">/optional-params/foo</router-link>

// 零個或多個引數
{ path: '/optional-params/*' }
<router-link to="/number">沒有引數</router-link>
<router-link to="/number/foo000">一個引數</router-link>
<router-link to="/number/foo111/fff222">多個引數</router-link>


// 一個或多個引數
{ path: '/optional-params/:foo+' }
<router-link to="/number/foo">一個引數</router-link>
<router-link to="/number/foo/foo111/fff222">多個引數</router-link>

// 自定義匹配引數
// 可以為所有引數提供一個自定義的regexp,它將覆蓋預設值([^\/]+)
{ path: '/optional-params/:id(\\d+)' }
{ path: '/optional-params/(foo/)?bar' }
複製程式碼

5、匹配優先順序

有時候一個路徑可能匹配多個路由,此時,匹配的優先順序就是按照路由的定義順序:先定義,優先順序最高。

6、push和replace的第二個第三個引數

在 2.2.0+,可選的在 router.push 或 router.replace 中提供 onComplete 和 onAbort 回撥作為第二個和第三個引數。這些回撥將會在導航成功完成 (在所有的非同步鉤子被解析之後) 或終止 (導航到相同的路由、或在當前導航完成之前導航到另一個不同的路由) 的時候進行相應的呼叫。在 3.1.0+,可以省略第二個和第三個引數,此時如果支援 Promise,router.push 或 router.replace 將返回一個 Promise。

// 元件1跳轉元件2

// 元件1
this.$router.push({ name: 'number' }, () => {
    console.log('元件1:onComplete回撥');
}, () => {
    console.log('元件1:onAbort回撥');
});
// 元件2
beforeRouteEnter(to, from, next) {
    console.log('元件2:beforeRouteEnter');
    next();
},
beforeCreate() {
    console.log('元件2:beforeCreate');
},
created() {
    console.log('元件2:created');
}
複製程式碼

Vue Router被我們忽略的知識點

// 元件2跳轉元件2(不帶引數)

this.$router.push({ name: 'number'}, () => {
    console.log('元件2:onComplete回撥');
}, () => {
    console.log('元件2,自我跳轉:onAbort回撥');
});
複製程式碼

Vue Router被我們忽略的知識點

// 元件2跳轉元件2(帶引數)

this.$router.push({ name: 'number', params: { foo: this.number}}, () => {
    console.log('元件2:onComplete回撥');
}, () => {
    console.log('元件2,自我跳轉:onAbort回撥');
});
複製程式碼

Vue Router被我們忽略的知識點

7、路由檢視

有時候想同時 (同級) 展示多個檢視,而不是巢狀展示,例如建立一個佈局,有 sidebar (側導航) 和 main (主內容) 兩個檢視,這個時候命名檢視就派上用場了。你可以在介面中擁有多個單獨命名的檢視,而不是隻有一個單獨的出口。如果 router-view 沒有設定名字,那麼預設為 default。

<router-view class="view one"></router-view>
<router-view class="view two" name="a"></router-view>
<router-view class="view three" name="b"></router-view>
複製程式碼

一個檢視使用一個元件渲染,因此對於同個路由,多個檢視就需要多個元件。確保正確使用 components 配置 (帶上 s):

const router = new VueRouter({
  routes: [
    {
      path: '/',
      components: {
        default: Foo,
        a: Bar,
        b: Baz
      }
    }
  ]
})
複製程式碼

8、重定向

{ path: '/a', redirect: '/b' }
{ path: '/a', redirect: { name: 'foo' }}
{ path: '/a', redirect: to => {
      // 方法接收 目標路由 作為引數
      // return 重定向的 字串路徑/路徑物件
}}
複製程式碼

注意導航守衛並沒有應用在跳轉路由上,而僅僅應用在其目標上。在下面這個例子中,為 /a 路由新增一個 beforeEach 或 beforeLeave 守衛並不會有任何效果。

9、使用props解耦$route

在元件中使用 $route 會使之與其對應路由形成高度耦合,從而使元件只能在某些特定的 URL 上使用,限制了其靈活性。

// router檔案
// 對於包含命名檢視的路由,你必須分別為每個命名檢視新增 `props` 選項:
{
    path: '/number/:name',
    props: true,
    // 物件模式 props: { newsletterPopup: false }
    // 函式模式 props: (route) => ({ query: route.parmas.name })
    name: 'number',
    component: () => import( /* webpackChunkName: "number" */ './views/Number.vue')
}
// 元件獲取
export default{
    props: ['name']
}
複製程式碼

10、全域性守衛

  • router.beforeEach 全域性前置守衛 進入路由之前。
  • router.beforeResolve 全域性解析守衛2.5.0新增。在beforeRouteEnter呼叫之後呼叫。
  • router.afterEach 全域性後置鉤子 進入路由之後。
// 入口檔案
import router from './router'

// 全域性前置守衛
router.beforeEach((to, from, next) => {
    console.log('beforeEach 全域性前置守衛');
    next();
});
// 全域性解析守衛
router.beforeResolve((to, from, next) => {
    console.log('beforeResolve 全域性解析守衛');
    next();
});
// 全域性後置守衛
router.afterEach((to, from) => {
    console.log('afterEach 全域性後置守衛');
});
複製程式碼

Vue Router被我們忽略的知識點

11、路由獨享守衛

  1. beforeEnter全域性前置守衛 進入路由之前。
{
    path: '/number/:name',
    props: true,
    name: 'number',
    // 路由獨享守衛
    beforeEnter: (to, from, next) => {
        console.log('beforeEnter 路由獨享守衛');
        next();
    },
    component: () => import( /* webpackChunkName: "number" */ './views/Number.vue')
}
複製程式碼

Vue Router被我們忽略的知識點

12、元件內守衛

  • beforeRouteEnter
  • beforeRouteUpdate(2.2新增)
  • beforeRouteLeave
beforeRouteEnter(to, from, next) {
    // 在渲染該元件的對應路由被 confirm 前呼叫
    // 不!能!獲取元件例項 `this`
    // 因為當守衛執行前,元件例項還沒被建立
    console.log('beforeRouteEnter 元件內進入守衛');
    next();
},
beforeRouteUpdate(to, from, next) {
    // 在當前路由改變,但是該元件被複用時呼叫
    // 舉例來說,對於一個帶有動態引數的路徑 /foo/:id,在 /foo/1 和 /foo/2 之間跳轉的時候,
    // 由於會渲染同樣的 Foo 元件,因此元件例項會被複用。而這個鉤子就會在這個情況下被呼叫。
    // 可以訪問元件例項 `this`
    console.log('beforeRouteUpdate 元件內更新守衛');
    next();
},
beforeRouteLeave(to, from, next) {
    // 導航離開該元件的對應路由時呼叫
    // 可以訪問元件例項 `this`
    console.log('beforeRouteLeave 元件內離開守衛');
    next();
}
複製程式碼

// 元件1跳轉到元件2,然後元件2跳轉元件2本身

Vue Router被我們忽略的知識點
// 元件1跳轉到元件2,然後元件2跳轉元件1
Vue Router被我們忽略的知識點

12、守衛的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() 註冊過的回撥。

13、滾動行為

使用前端路由,當切換到新路由時,想要頁面滾到頂部,或者是保持原先的滾動位置,就像重新載入頁面那樣。 vue-router 能做到,而且更好,它讓你可以自定義路由切換時頁面如何滾動。

注意: 這個功能只在支援 history.pushState 的瀏覽器中可用。

// 一般滾動
scrollBehavior(to, from, savedPosition) {
    if (savedPosition) {
        // 在瀏覽器按下 後退/前進按鈕時
        return savedPosition
    } else {
        return { x: 0, y: 0 }
    }
}

// 錨點滾動
scrollBehavior(to, from, savedPosition) {
    if (to.hash) {
        return {
            selector: to.hash
        }
    }
}

// 非同步滾動  2.8.0 新增
scrollBehavior(to, from, savedPosition) {
    return new Promise((resolve, reject) => {
        setTimeout(() => {
            resolve({ x: 0, y: 0 })
        }, 500)
    })
}  

複製程式碼

相關文章