vue-router詳解


對於單頁應用,官方提供了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的語法進行配置,也是很容易做到的:

  1. 先建立一個路由器模塊,主要進行配置和綁定相關信息
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; //將路由器導出
  1. 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-transitiontransition-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/。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM