前言

Vue Router 是 Vue.js 官方的路由管理器。

它和 Vue.js 的核心深度集成，讓構(gòu)建單頁面應(yīng)用變得易如反掌。

[[397463]]

包含的功能有：

• 嵌套的路由/視圖表
• 模塊化的、基于組件的路由配置
• 路由參數(shù)、查詢、通配符
• 基于 Vue.js 過渡系統(tǒng)的視圖過渡效果
• 細(xì)粒度的導(dǎo)航控制
• 帶有自動激活的 CSS class 的鏈接
• HTML5 歷史模式或 hash 模式，在 IE9 中自動降級
• 自定義的滾動條行為

本文是作者是實際項目中遇到的一些總結(jié)，主要包括：

1. 響應(yīng)路由參數(shù)變化
2. 路由匹配
3. 高級匹配模式
4. 匹配優(yōu)先級
5. push和replace的第二個第三個參數(shù)
6. 路由視圖
7. 重定向
8. 使用props解耦$route
9. 導(dǎo)航守衛(wèi)
10. 守衛(wèi)的next方法

希望本文對你有所幫助。

正文

1. 響應(yīng)路由參數(shù)變化

針對復(fù)用組件(只是路由參數(shù)發(fā)生改變)，生命周期函數(shù)鉤子不會被調(diào)用，如何能刷新組件了?

watch監(jiān)聽 

watch: { 
  '$route' (to, from) { 
  // 對路由變化作出響應(yīng)... 
  } 
} 

beforeRouteUpdate 

beforeRouteUpdate (to, from, next) { 
// react to route changes... 
/ / don't forget to call next() 
} 

2. 路由匹配 

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

注意：當(dāng)使用通配符路由時，請確保路由的順序是正確的，也就是說含有通配符的路由應(yīng)該放在最后。路由 { path: '*' } 通常用于客戶端 404 錯誤。

如果你使用了History 模式，請確保正確配置你的服務(wù)器。

當(dāng)使用一個通配符時，$route.params 內(nèi)會自動添加一個名為 pathMatch 參數(shù)。

它包含了 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' 

3. 高級匹配模式 

// 命名參數(shù)必須有"單個字符"[A-Za-z09]組成 
  
// ?可選參數(shù) 
{ path: '/optional-params/:foo?' } 
// 路由跳轉(zhuǎn)是可以設(shè)置或者不設(shè)置foo參數(shù)，可選 
<router-link to="/optional-params">/optional-params</router-link> 
<router-link to="/optional-params/foo">/optional-params/foo</router-link> 
  
// 零個或多個參數(shù) 
{ path: '/optional-params/*' } 
<router-link to="/number">沒有參數(shù)</router-link> 
<router-link to="/number/foo000">一個參數(shù)</router-link> 
<router-link to="/number/foo111/fff222">多個參數(shù)</router-link> 
  
  
// 一個或多個參數(shù) 
{ path: '/optional-params/:foo+' } 
<router-link to="/number/foo">一個參數(shù)</router-link> 
<router-link to="/number/foo/foo111/fff222">多個參數(shù)</router-link> 
  
// 自定義匹配參數(shù) 
// 可以為所有參數(shù)提供一個自定義的regexp，它將覆蓋默認(rèn)值（[^\/]+） 
{ path: '/optional-params/:id(\\d+)' } 
{ path: '/optional-params/(foo/)?bar' } 

4. 匹配優(yōu)先級

有時候一個路徑可能匹配多個路由。

此時，匹配的優(yōu)先級就是按照路由的定義順序：先定義，優(yōu)先級最高。

5. push和replace的第二個第三個參數(shù)

在 2.2.0+版本，可選的在 router.push 或 router.replace 中提供 onComplete 和 onAbort 回調(diào)作為第二個和第三個參數(shù)。

這些回調(diào)將會在導(dǎo)航成功完成 (在所有的異步鉤子被解析之后) 或終止 (導(dǎo)航到相同的路由、或在當(dāng)前導(dǎo)航完成之前導(dǎo)航到另一個不同的路由) 的時候進(jìn)行相應(yīng)的調(diào)用。在 3.1.0+，可以省略第二個和第三個參數(shù)，此時如果支持 Promise，router.push 或 router.replace 將返回一個 Promise。

接下來看幾個例子來看看第二個第三個參數(shù)的調(diào)用時機：

1. 組件1跳轉(zhuǎn)組件2 

// 組件1 
this.$router.push({ name: 'number' }, () => { 
  console.log('組件1：onComplete回調(diào)'); 
}, () => { 
  console.log('組件1：onAbort回調(diào)'); 
}); 
 
// 組件2 
beforeRouteEnter(to, from, next) { 
  console.log('組件2：beforeRouteEnter'); 
  next(); 
}, 
beforeCreate() { 
  console.log('組件2：beforeCreate'); 
}, 
created() { 
  console.log('組件2：created'); 
} 

 

組件之間跳轉(zhuǎn)觸發(fā)onComplete回調(diào)。

2. 組件2跳轉(zhuǎn)組件2(不帶參數(shù)) 

this.$router.push({ name: 'number'}, () => { 
  console.log('組件2：onComplete回調(diào)'); 
}, () => { 
  console.log('組件2,自我跳轉(zhuǎn)：onAbort回調(diào)'); 
}); 

 

組件自我跳轉(zhuǎn)當(dāng)不帶參數(shù)時觸發(fā)onAbort回調(diào)。但是當(dāng)自我跳轉(zhuǎn)帶參數(shù)時可能情況就有點不一樣。

3. 組件2跳轉(zhuǎn)組件2(帶參數(shù)) 

this.$router.push({ name: 'number', params: { foo: this.number}}, () => { 
    console.log('組件2：onComplete回調(diào)'); 
}, () => { 
    console.log('組件2,自我跳轉(zhuǎn)：onAbort回調(diào)'); 
}); 

 

組件自我?guī)?shù)跳轉(zhuǎn)，onComplete回調(diào)、onAbort回調(diào)回調(diào)都不會觸發(fā)。

6. 路由視圖

有時候想同時 (同級) 展示多個視圖，而不是嵌套展示，例如創(chuàng)建一個布局，有 sidebar (側(cè)導(dǎo)航) 和 main (主內(nèi)容) 兩個視圖，這個時候命名視圖就派上用場了。

你可以在界面中擁有多個單獨命名的視圖，而不是只有一個單獨的出口。

如果 router-view 沒有設(shè)置名字，那么默認(rèn)為 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 
    } 
    } 
  ] 
}); 

7. 重定向 

{ path: '/a', redirect: '/b' } 
{ path: '/a', redirect: { name: 'foo' }} 
{ path: '/a', redirect: to => { 
  // 方法接收 目標(biāo)路由 作為參數(shù) 
  // return 重定向的 字符串路徑/路徑對象 
}} 

注意：導(dǎo)航守衛(wèi)并沒有應(yīng)用在跳轉(zhuǎn)路由上，而僅僅應(yīng)用在其目標(biāo)上。

在上面這個例子中，為 /a 路由添加一個 beforeEach 或 beforeLeave 守衛(wèi)并不會有任何效果。

8. 使用props解耦$route

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

// router文件 
// 對于包含命名視圖的路由，你必須分別為每個命名視圖添加 `props` 選項： 
{ 
  path: '/number/:name', 
  props: true, 
  // 對象模式 props: { newsletterPopup: false } 
  // 函數(shù)模式 props: (route) => ({ query: route.parmas.name }) 
  name: 'number', 
  component: () => import( /* webpackChunkName: "number" */ './views/Number.vue') 
} 
 
// 組件獲取 
export default{ 
  props: ['name'] 
} 

9. 導(dǎo)航守衛(wèi)

1. 三種全局守衛(wèi)

• router.beforeEach 全局前置守衛(wèi) 進(jìn)入路由之前。
• router.beforeResolve 全局解析守衛(wèi)2.5.0新增。在beforeRouteEnter調(diào)用之后調(diào)用。
• router.afterEach 全局后置鉤子 進(jìn)入路由之后。 

// 入口文件 
import router from './router' 
  
// 全局前置守衛(wèi) 
router.beforeEach((to, from, next) => { 
console.log('beforeEach 全局前置守衛(wèi)'); 
next(); 
}); 
// 全局解析守衛(wèi) 
router.beforeResolve((to, from, next) => { 
console.log('beforeResolve 全局解析守衛(wèi)'); 
next(); 
}); 
// 全局后置守衛(wèi) 
router.afterEach((to, from) => { 
console.log('afterEach 全局后置守衛(wèi)'); 
}); 

2. 路由獨享守衛(wèi)

beforeEnter全局前置守衛(wèi)進(jìn)入路由之前。 

{ 
  path: '/number/:name', 
  props: true, 
  name: 'number', 
  // 路由獨享守衛(wèi) 
  beforeEnter: (to, from, next) => { 
      console.log('beforeEnter 路由獨享守衛(wèi)'); 
      next(); 
  }, 
  component: () => import( /* webpackChunkName: "number" */ './views/Number.vue') 
} 

 

3. 組件內(nèi)守衛(wèi)

• beforeRouteEnter
• beforeRouteUpdate(2.2新增)
• beforeRouteLeave 

beforeRouteEnter(to, from, next) { 
  // 在渲染該組件的對應(yīng)路由被 confirm 前調(diào)用 
  // 不！能！獲取組件實例 `this` 
  // 因為當(dāng)守衛(wèi)執(zhí)行前，組件實例還沒被創(chuàng)建 
  console.log('beforeRouteEnter 組件內(nèi)進(jìn)入守衛(wèi)'); 
  next(); 
}, 
beforeRouteUpdate(to, from, next) { 
  // 在當(dāng)前路由改變，但是該組件被復(fù)用時調(diào)用 
  // 舉例來說，對于一個帶有動態(tài)參數(shù)的路徑 /foo/:id，在 /foo/1 和 /foo/2 之間跳轉(zhuǎn)的時候， 
  // 由于會渲染同樣的 Foo 組件，因此組件實例會被復(fù)用。而這個鉤子就會在這個情況下被調(diào)用。 
  // 可以訪問組件實例 `this` 
  console.log('beforeRouteUpdate 組件內(nèi)更新守衛(wèi)'); 
  next(); 
}, 
beforeRouteLeave(to, from, next) { 
  // 導(dǎo)航離開該組件的對應(yīng)路由時調(diào)用 
  // 可以訪問組件實例 `this` 
  console.log('beforeRouteLeave 組件內(nèi)離開守衛(wèi)'); 
  next(); 
} 

• 組件1跳轉(zhuǎn)到組件2，然后組件2跳轉(zhuǎn)組件2本身 

• 組件1跳轉(zhuǎn)到組件2，然后組件2跳轉(zhuǎn)組件1

10. 守衛(wèi)的 next 方法

• next: 調(diào)用該方法 resolve 鉤子。
• next(): 進(jìn)行管道中的下一個鉤子。如果全部鉤子執(zhí)行完了，則導(dǎo)航的狀態(tài)就是 confirmed (確認(rèn)的)。
• next(false): 中斷當(dāng)前的導(dǎo)航。如果瀏覽器的 URL 改變了 (可能是用戶手動或者瀏覽器后退按鈕)，那么 URL 地址會重置到 from 路由對應(yīng)的地址。
• next('/') 或者 next({ path: '/' }): 跳轉(zhuǎn)到一個不同的地址。當(dāng)前的導(dǎo)航被中斷，然后進(jìn)行一個新的導(dǎo)航。你可以向 next 傳遞任意位置對象，且允許設(shè)置諸如 replace: true、name: 'home' 之類的選項以及任何用在 router-link 的 to prop 或 router.push 中的選項。
• next(error): (2.4.0+) 如果傳入 next 的參數(shù)是一個 Error 實例，則導(dǎo)航會被終止且該錯誤會被傳遞給 router.onError() 注冊過的回調(diào)。

最后

最終還是希望大家多看看文檔，理解了再去使用到項目中，不至于使用之后出現(xiàn) bug，謝謝。