對於單頁應用,官方提供了vue-router
進行路由跳轉的處理,本篇主要也是基於其官方文檔寫作而成。
安裝
基於傳統,我更喜歡采用npm包的形式進行安裝。
npm install vue-router --save
當然,官方采用了多種方式進行安裝,包括bower
,cdn
等。
基本用法
在HTML文檔中使用,只需要利用v-link
這個directive就行了,如:
<a v-link="{path: '/view-a'}">Go to view-a</a>
ps: v-link
還支持activeClass用於指定鏈接活躍時的css樣式。replace屬性為true
的時候可以讓鏈接在跳轉的時候不會留下歷史記錄。
而在ES5中使用,需要先創建路由器實例,隨后傳入配置參數即可,如:
var router = new VueRouter(); router.map({ '/view-a': { component: ViewA }, '/view-b': { component: ViewB } }); router.start(App, '#app');
以上定義的路由器規則,采用映射到一個組件的方式,最后啟動應用的時候,掛載到#app
的元素上。
當然,如果你想采用ES6的語法進行配置,也是很容易做到的:
- 先建立一個路由器模塊,主要進行配置和綁定相關信息
import Vue from 'vue'; import VueRouter from 'vue-router'; Vue.use(VueRouter); const router = new VueRouter(); //這里可以帶有路由器的配置參數 router.map({ '/view-a': { component: ViewA }, '/view-b': { component: ViewB } }); export default router; //將路由器導出
- 在
app.js
入口啟動文件中啟用該路由器
import Vue from 'vue'; import router from './routers'; router.start(App, '#app');
嵌套路由
如果想要使用嵌套路由,如/a/b
則可以更新路由配置
router.map({
'/a': { component: A, subRoutes: { '/b': { component: B } } } });
同時,你需要在組件A和組件B中使用<router-view>
,如:
<div id="app"> <router-view></router-view> </div>
組件A中,使用嵌套的外鏈
<div id="A"> <h1> This is component A </h1> <router-view></router-view> </div>
路由器將自動渲染對應的組件以及更新路由信息。
其中<router-view>
可以傳遞props,支持v-ref
,同時也可以使用v-transition
和transition-mode
來獲得場景切換效果,被渲染的組件將注冊到父級組件的this.$
對象上。
路由對象和路由匹配
路由對象,即$router
會被注入每個組件中,可以利用它進行一些信息的獲取。如
屬性 | 說明 |
---|---|
$route.path | 當前路由對象的路徑,如'/view/a' |
$rotue.params | 關於動態片段(如/user/:username )的鍵值對信息,如{username: 'paolino'} |
$route.query | 請求參數,如/foo?user=1 獲取到query.user = 1 |
$route.router | 所屬路由器以及所屬組件信息 |
$route.matched | 數組,包含當前匹配的路徑中所包含的所有片段所對應的配置參數對象。 |
$route.name | 當前路徑名字 |
當然,你也可以在自己定義路由規則(map
)的時候自定義字段,用以特殊目的。
全匹配片段的語法是使用通配符*
如,/user/*any
就會匹配到任何以/user為開頭的路徑,並給params
對象中賦值一個屬性any
動態片段的語法就是使用:
作為標志。
使用路徑名稱
在定義路徑規則的時候,如果你給它提供了一個name
屬性,則可以在后續使用這條路徑規則的時候,直接引用。
router.map({
'/user/:userId': { name: 'user', component: {...} } });
在v-link
中使用
<a v-link="{name: 'user', params: {userId: 1}">This is a user whose id is 1</a>
還可以使用router.go()
router.go({name: 'user', params: {userId: 1}});
最終都會匹配到/user/1
這條路徑上
路由選項
路由選項名 | 默認值 | 作用 |
---|---|---|
hashbang | true | 將路徑格式化為#! 開頭 |
history | false | 啟用HTML5 history模式,可以使用pushState和replaceState來管理記錄 |
abstract | false | 使用一個不依賴於瀏覽器的瀏覽歷史虛擬管理后端。 |
transitionOnLoad | false | 初次加載是否啟用場景切換 |
saveScrollPosition | false | 在啟用html5 history模式的時候生效,用於后退操作的時候記住之前的滾動條位置 |
linkActiveClass | "v-link-active" | 鏈接被點擊時候需要添加到v-link 元素上的class類,默認為active |
如,我想采用一個有路徑格式化並啟用Html5 history功能的路由器,則可以在路由器初始化的時候,指定這些參數:
var router = new VueRouter({ hashbang: true, history: true });
這里只是做了一些簡單的介紹,更多選項其參考官方文檔http://router.vuejs.org/zh-cn/。