在Web開發中,路由是指根據URL分配到對應的處理程序。對於大多數單頁面應用,都推薦使用官方支持的vue-router。Vue-router經過管理URL,實現URL和組件的對應,以及經過URL進行組件之間的切換。本文將詳細介紹Vue路由vue-routerhtml
在使用vue-router以前,首先須要安裝該插件前端
npm install vue-router
若是在一個模塊化工程中使用它,必需要經過 Vue.use()
明確地安裝路由功能vue
import Vue from 'vue' import VueRouter from 'vue-router' Vue.use(VueRouter)
若是使用全局的 script 標籤,則無須如此webpack
用Vue.js + vue-router建立單頁應用很是簡單。使用Vue.js ,已經能夠經過組合組件來組成應用程序,把vue-router添加進來,須要作的是,將組件(components)映射到路由(routes),而後告訴 vue-router 在哪裏渲染它們nginx
下面是一個實例web
<div id="app"> <h1>Hello App!</h1> <p> <!-- 使用 router-link 組件來導航,經過傳入 `to` 屬性指定連接,<router-link> 默認會被渲染成一個 `<a>` 標籤 --> <router-link to="/foo">Go to Foo</router-link> <router-link to="/bar">Go to Bar</router-link> </p> <!-- 路由出口,路由匹配到的組件將渲染在這裏 --> <router-view></router-view> </div> <script src="vue.js"></script> <script src="vue-router.js"></script> <script> // 0. 若是使用模塊化機制編程,導入Vue和VueRouter,要調用 Vue.use(VueRouter) // 1. 定義(路由)組件,能夠從其餘文件 import 進來 const Foo = { template: '<div>foo</div>' } const Bar = { template: '<div>bar</div>' } // 2. 定義路由 // 每一個路由應該映射一個組件。 其中"component" 能夠是經過 Vue.extend() 建立的組件構造器,或者,只是一個組件配置對象。 const routes = [ { path: '/foo', component: Foo }, { path: '/bar', component: Bar } ] // 3. 建立 router 實例,而後傳 `routes` 配置,固然還能夠傳別的配置參數 const router = new VueRouter({ routes // (縮寫)至關於 routes: routes }) // 4. 建立和掛載根實例。 // 經過 router 配置參數注入路由,從而讓整個應用都有路由功能 const app = new Vue({
el:'#app',
router
})</script>
vue-router
默認 hash 模式 —— 使用 URL 的 hash 來模擬一個完整的 URL,因而當 URL 改變時,頁面不會從新加載vue-router
http://localhost:8080/#/Hello
若是不想要很醜的 hash,能夠用路由的 history 模式,這種模式充分利用 history.pushState
API 來完成 URL 跳轉而無須從新加載頁面apache
const router = new VueRouter({
mode: 'history', routes: [...] })
當使用 history 模式時,URL 就像正常的 urlnpm
http://localhost:8080/Hello
不過這種模式須要後臺配置支持。若是後臺沒有正確的配置,當用戶在瀏覽器直接訪問 http://oursite.com/user/id
就會返回 404編程
【服務器配置】
若是要使用history模式,則須要進行服務器配置
因此,要在服務端增長一個覆蓋全部狀況的候選資源:若是 URL 匹配不到任何靜態資源,則應該返回同一個 index.html
頁面,這個頁面就是app 依賴的頁面
下面是一些配置的例子
apache
以wamp爲例,須要對httpd.conf配置文件進行修改
首先,去掉rewrite_module前面的#號註釋
LoadModule rewrite_module modules/mod_rewrite.so
而後,將文檔全部的AllowOverride設置爲all
AllowOverride all
最後,須要保存一個.htaccess文件放置在根路徑下面,文件內容以下
<IfModule mod_rewrite.c> RewriteEngine On RewriteBase / RewriteRule ^index\.html$ - [L] RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule . /index.html [L] </IfModule>
nginx
location / { try_files $uri $uri/ /index.html; }
【注意事項】
這麼作之後,服務器就再也不返回404錯誤頁面,由於對於全部路徑都會返回 index.html
文件。爲了不這種狀況,應該在Vue應用裏面覆蓋全部的路由狀況,而後再給出一個404頁面
const router = new VueRouter({ mode: 'history', routes: [ { path: '*', component: NotFoundComponent } ] })
或者,若是是用 Node.js 做後臺,可使用服務端的路由來匹配 URL,當沒有匹配到路由的時候返回 404,從而實現 fallback
const Foo = { template: '<div>foo</div>' } const Bar = { template: '<div>bar</div>' } const NotFound = {template:'<div>not found</div>'} const routes = [ { path: '/foo', component: Foo }, { path: '/bar', component: Bar }, { path: '*', component: NotFound}, ]
【重定向】
重定向經過 routes
配置來完成,下面例子是從 /a
重定向到 /b
const router = new VueRouter({ routes: [ { path: '/a', redirect: '/b' } ] })
重定向的目標也能夠是一個命名的路由:
const router = new VueRouter({ routes: [ { path: '/a', redirect: { name: 'foo' }} ] })
甚至是一個方法,動態返回重定向目標:
const router = new VueRouter({ routes: [ { path: '/a', redirect: to => { // 方法接收 目標路由 做爲參數 // return 重定向的 字符串路徑/路徑對象
return '/home' }} ] })
對於不識別的URL地址來講,經常使用重定向功能,將頁面定向到首頁顯示
const Foo = { template: '<div>foo</div>' } const Bar = { template: '<div>bar</div>' } const routes = [ { path: '/foo', component: Foo }, { path: '/bar', component: Bar }, { path: '*', redirect: "/foo"}, ]
【別名】
重定向是指,當用戶訪問 /a
時,URL 將會被替換成 /b
,而後匹配路由爲 /b
,那麼別名是什麼呢?/a
的別名是 /b
,意味着,當用戶訪問 /b
時,URL 會保持爲 /b
,可是路由匹配則爲 /a
,就像用戶訪問 /a
同樣
上面對應的路由配置爲
const router = new VueRouter({ routes: [ { path: '/a', component: A, alias: '/b' } ] })
『別名』的功能能夠自由地將 UI 結構映射到任意的 URL,而不是受限於配置的嵌套路由結構
處理首頁訪問時,經常將index設置爲別名,好比將'/home'的別名設置爲'/index'。可是,要注意的是,<router-link to="/home">的樣式在URL爲/index時並不會顯示。由於,router-link只識別出了home,而沒法識別index
設置根路徑,須要將path設置爲'/'
<p> <router-link to="/">index</router-link> <router-link to="/foo">Go to Foo</router-link> <router-link to="/bar">Go to Bar</router-link> </p> const routes = [ { path: '/', component: Home }, { path: '/foo', component: Foo }, { path: '/bar', component: Bar }, ]
可是,因爲默認使用的是全包含匹配,即'/foo'、'/bar'也能夠匹配到'/',若是須要精確匹配,僅僅匹配'/',則須要在router-link中設置exact屬性
<p> <router-link to="/" exact>index</router-link> <router-link to="/foo">Go to Foo</router-link> <router-link to="/bar">Go to Bar</router-link> </p> const routes = [ { path: '/', component: Home }, { path: '/foo', component: Foo }, { path: '/bar', component: Bar }, ]
實際生活中的應用界面,一般由多層嵌套的組件組合而成。一樣地,URL中各段動態路徑也按某種結構對應嵌套的各層組件
/user/foo/profile /user/foo/posts
+------------------+ +-----------------+
| User | | User |
| +--------------+ | | +-------------+ |
| | Profile | | +------------> | | Posts | |
| | | | | | | |
| +--------------+ | | +-------------+ |
+------------------+ +-----------------+
藉助 vue-router
,使用嵌套路由配置,就能夠很簡單地表達這種關係
<div id="app"> <p> <router-link to="/" exact>index</router-link> <router-link to="/foo">Go to Foo</router-link> <router-link to="/bar">Go to Bar</router-link> </p> <router-view></router-view> </div>
const Home = { template: '<div>home</div>' } const Foo = { template: ` <div> <p> <router-link to="/foo/foo1">to Foo1</router-link> <router-link to="/foo/foo2">to Foo2</router-link> <router-link to="/foo/foo3">to Foo3</router-link> </p> <router-view></router-view> </div> ` } const Bar = { template: '<div>bar</div>' } const Foo1 = { template: '<div>Foo1</div>' } const Foo2 = { template: '<div>Foo2</div>' } const Foo3 = { template: '<div>Foo3</div>' }
const routes = [ { path: '/', component: Home }, { path: '/foo', component: Foo ,children:[ {path:'foo1',component:Foo1}, {path:'foo2',component:Foo2}, {path:'foo3',component:Foo3}, ]}, { path: '/bar', component: Bar }, ]
要特別注意的是,router的構造配置中,children屬性裏的path屬性只設置爲當前路徑,由於其會依據層級關係;而在router-link的to屬性則須要設置爲徹底路徑
若是要設置默認子路由,即點擊foo時,自動觸發foo1,則須要進行以下修改。將router配置對象中children屬性的path屬性設置爲'',並將對應的router-link的to屬性設置爲'/foo'
const Foo = { template: `
<div>
<p>
<router-link to="/foo" exact>to Foo1</router-link>
<router-link to="/foo/foo2">to Foo2</router-link>
<router-link to="/foo/foo3">to Foo3</router-link>
</p>
<router-view></router-view>
</div>
` }
const routes = [ { path: '/', component: Home }, { path: '/foo', component: Foo ,children:[ {path:'',component:Foo1}, {path:'foo2',component:Foo2}, {path:'foo3',component:Foo3}, ]}, { path: '/bar', component: Bar }, ]
結果以下所示
有時,經過一個名稱來標識一個路由顯得更方便,特別是在連接一個路由,或者是執行一些跳轉時。能夠在建立Router實例時,在routes
配置中給某個路由設置名稱
const router = new VueRouter({
routes: [
{
path: '/user/:userId', name: 'user', component: User } ] })
要連接到一個命名路由,能夠給 router-link
的 to
屬性傳一個對象:
<router-link :to="{ name: 'user', params: { userId: 123 }}">User</router-link>
這跟代碼調用 router.push()
是一回事
router.push({ name: 'user', params: { userId: 123 }})
這兩種方式都會把路由導航到 /user/123
路徑
命名路由的常見用途是替換router-link中的to屬性,若是不使用命名路由,由router-link中的to屬性須要設置全路徑,不夠靈活,且修改時較麻煩。使用命名路由,只須要使用包含name屬性的對象便可
[注意]若是設置了默認子路由,則不要在父級路由上設置name屬性
<div id="app"> <p> <router-link to="/" exact>index</router-link> <router-link :to="{ name: 'foo1' }">Go to Foo</router-link> <router-link :to="{ name: 'bar' }">Go to Bar</router-link> </p> <router-view></router-view> </div>
const Home = { template: '<div>home</div>' } const Foo = { template: ` <div> <p> <router-link :to="{ name: 'foo1' }" exact>to Foo1</router-link> <router-link :to="{ name: 'foo2' }" >to Foo2</router-link> <router-link :to="{ name: 'foo3' }" >to Foo3</router-link> </p> <router-view></router-view> </div> ` } const Bar = { template: '<div>bar</div>' } const Foo1 = { template: '<div>Foo1</div>' } const Foo2 = { template: '<div>Foo2</div>' } const Foo3 = { template: '<div>Foo3</div>' }
const routes = [
{ path: '/', name:'home', component: Home },
{ path: '/foo', component: Foo ,children:[
{path:'',name:'foo1', component:Foo1},
{path:'foo2',name:'foo2', component:Foo2},
{path:'foo3',name:'foo3', component:Foo3},
]},
{ path: '/bar', name:'bar', component: Bar },
]
結果以下所示
有時候想同時(同級)展現多個視圖,而不是嵌套展現,例如建立一個佈局,有 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
配置
const router = new VueRouter({
routes: [
{
path: '/', components: { default: Foo, a: Bar, b: Baz } } ] })
下面是一個實例
<div id="app"> <p> <router-link to="/" exact>index</router-link> <router-link :to="{ name: 'foo' }">Go to Foo</router-link> <router-link :to="{ name: 'bar' }">Go to Bar</router-link> </p> <router-view></router-view> <router-view name="side"></router-view> </div>
const Home = { template: '<div>home</div>' } const Foo = { template: '<div>Foo</div>'} const MainBar = { template: '<div>mainBar</div>' } const SideBar = { template: '<div>sideBar</div>' } const routes = [ { path: '/', name:'home', component: Home }, { path: '/foo', name:'foo', component: Foo}, { path: '/bar', name:'bar', components: { default: MainBar, side:SideBar } }, ]
結果以下所示
常常須要把某種模式匹配到的全部路由,全都映射到同個組件。例如,有一個 User
組件,對於全部 ID 各不相同的用戶,都要使用這個組件來渲染。那麼,能夠在 vue-router
的路由路徑中使用動態路徑參數(dynamic segment)來達到這個效果
const User = { template: '<div>User</div>' } const router = new VueRouter({ routes: [ // 動態路徑參數以冒號開頭 { path: '/user/:id', component: User } ] })
如今,像 /user/foo
和 /user/bar
都將映射到相同的路由
下面是一個比較完整的實例,path:'/user/:id?'表示有沒有子路徑均可以匹配
<div id="app"> <router-view></router-view> <br> <p> <router-link to="/" exact>index</router-link> <router-link :to="{name:'user'}">User</router-link> <router-link :to="{name:'bar'}">Go to Bar</router-link> </p> </div> const home = { template: '<div>home</div>'}; const bar = { template: '<div>bar</div>'}; const user = {template: `<div> <p>user</p> <router-link style="margin: 0 10px" :to="'/user/' + item.id" v-for="item in userList" key="item.id">{{item.userName}}</router-link> </div>`, data(){ return{userList:[{id:1,userName:'u1'},{id:2,userName:'u2'},{id:3,userName:'u3'}]} } }; const app = new Vue({ el:'#app', router:new VueRouter({ routes: [ { path: '/', name:'home', component:home }, { path: '/user/:id?', name:'user', component:user}, { path: '/bar', name:'bar', component:bar}, ], }), })
一個路徑參數使用冒號 :
標記。當匹配到一個路由時,參數值會被設置到 this.$route.params
,能夠在每一個組件內使用。因而,能夠更新 User
的模板,輸出當前用戶的 ID:
const User = { template: '<div>User {{ $route.params.id }}</div>' }
下面是一個實例
<div id="app"> <p> <router-link to="/user/foo">/user/foo</router-link> <router-link to="/user/bar">/user/bar</router-link> </p> <router-view></router-view> </div> <script src="vue.js"></script> <script src="vue-router.js"></script> <script> const User = { template: `<div>User {{ $route.params.id }}</div>` } const router = new VueRouter({ routes: [ { path: '/user/:id', component: User } ] }) const app = new Vue({ router }).$mount('#app') </script>
能夠在一個路由中設置多段『路徑參數』,對應的值都會設置到 $route.params
中。例如:
模式 匹配路徑 $route.params /user/:username /user/evan { username: 'evan' } /user/:username/post/:post_id /user/evan/post/123 { username: 'evan', post_id: 123 }
除了 $route.params
外,$route
對象還提供了其它有用的信息,例如,$route.query
(若是 URL 中有查詢參數)、$route.hash
等等
【響應路由參數的變化】
使用路由參數時,例如從 /user/foo
導航到 user/bar
,原來的組件實例會被複用。由於兩個路由都渲染同個組件,比起銷燬再建立,複用則顯得更加高效。不過,這也意味着組件的生命週期鉤子不會再被調用
複用組件時,想對路由參數的變化做出響應的話,能夠簡單地 watch(監測變化) $route
對象:
const User = { template: '...', watch: { '$route' (to, from) { // 對路由變化做出響應... } } }
[注意]有時同一個路徑能夠匹配多個路由,此時,匹配的優先級就按照路由的定義順序:誰先定義的,誰的優先級就最高
下面是一個實例
const home = { template: '<div>home</div>'}; const bar = { template: '<div>bar</div>'}; const user = {template: `<div> <p>user</p> <router-link style="margin: 0 10px" :to="'/user/' +item.type + '/'+ item.id" v-for="item in userList" key="item.id">{{item.userName}}</router-link> <div v-if="$route.params.id"> <div>id:{{userInfo.id}};userName:{{userInfo.userName}} ;type:{{userInfo.type}};</div> </div> </div>`, data(){ return{ userList:[{id:1,type:'vip',userName:'u1'},{id:2,type:'common',userName:'u2'},{id:3,type:'vip',userName:'u3'}], userInfo:null, } }, methods:{ getData(){ let id = this.$route.params.id; if(id){ this.userInfo = this.userList.filter((item)=>{ return item.id == id; })[0] }else{ this.userInfo = {}; } } }, created(){ this.getData(); }, watch:{ $route(){ this.getData(); }, } }; const app = new Vue({ el:'#app', router:new VueRouter({ routes: [ { path: '/', name:'home', component:home }, { path: '/user/:type?/:id?', name:'user', component:user}, { path: '/bar', name:'bar', component:bar}, ], }), })
實現子路由,除了使用動態參數,也可使用查詢字符串
const home = { template: '<div>home</div>'}; const bar = { template: '<div>bar</div>'}; const user = {template: `<div> <p>user</p> <router-link style="margin: 0 10px" :to="'/user/' +item.type + '/'+ item.id" v-for="item in userList" key="item.id">{{item.userName}}</router-link> <div v-if="$route.params.id"> <div>id:{{userInfo.id}};userName:{{userInfo.userName}} ;type:{{userInfo.type}};</div> <router-link to="?info=follow" exact>關注</router-link> <router-link to="?info=share" exact>分享</router-link> </div> </div>`, data(){ return{ userList:[{id:1,type:'vip',userName:'u1'},{id:2,type:'common',userName:'u2'},{id:3,type:'vip',userName:'u3'}], userInfo:null, } }, methods:{ getData(){ let id = this.$route.params.id; if(id){ this.userInfo = this.userList.filter((item)=>{ return item.id == id; })[0] }else{ this.userInfo = {}; } } }, created(){ this.getData(); }, watch:{ $route(){ this.getData(); }, } }; const app = new Vue({ el:'#app', router:new VueRouter({ routes: [ { path: '/', name:'home', component:home }, { path: '/user/:type?/:id?', name:'user', component:user}, { path: '/bar', name:'bar', component:bar}, ], }), })
當須要設置默認查詢字符串時,進行以下設置
const user = {template: `<div> <p>user</p> <router-link style="margin: 0 10px" :to="{path:'/user/' +item.type + '/'+ item.id,query:{info:'follow'}}" v-for="item in userList" key="item.id">{{item.userName}}</router-link> <div v-if="$route.params.id"> <div>id:{{userInfo.id}};userName:{{userInfo.userName}} ;type:{{userInfo.type}};</div> <router-link to="?info=follow" exact>關注</router-link> <router-link to="?info=share" exact>分享</router-link> {{$route.query}} </div> </div>`, data(){ return{ userList:[{id:1,type:'vip',userName:'u1'},{id:2,type:'common',userName:'u2'},{id:3,type:'vip',userName:'u3'}], userInfo:null, } }, methods:{ getData(){ let id = this.$route.params.id; if(id){ this.userInfo = this.userList.filter((item)=>{ return item.id == id; })[0] }else{ this.userInfo = {}; } } }, created(){ this.getData(); }, watch:{ $route(){ this.getData(); }, } };
使用前端路由,當切換到新路由時,想要頁面滾到頂部,或者是保持原先的滾動位置,就像從新加載頁面那樣。 vue-router
能作到,並且更好,它能夠自定義路由切換時頁面如何滾動
[注意]這個功能只在 HTML5 history 模式下可用
當建立一個 Router 實例,能夠提供一個 scrollBehavior
方法。該方法在前進、後退或切換導航時觸發
const router = new VueRouter({
routes: [...],
scrollBehavior (to, from, savedPosition) {
// return 指望滾動到哪一個的位置
}
})
scrollBehavior
方法返回 to
和 from
路由對象。第三個參數 savedPosition
當且僅當 popstate
導航 (經過瀏覽器的 前進/後退 按鈕觸發) 時纔可用,返回滾動條的座標{x:number,y:number}
若是返回一個布爾假的值,或者是一個空對象,那麼不會發生滾動
scrollBehavior (to, from, savedPosition) {
return { x: 0, y: 0 }
}
對於全部路由導航,簡單地讓頁面滾動到頂部。返回 savedPosition
,在按下 後退/前進 按鈕時,就會像瀏覽器的原生表現那樣:
scrollBehavior (to, from, savedPosition) {
if (savedPosition) {
return savedPosition
} else {
return { x: 0, y: 0 }
}
}
下面是一個實例,點擊導航進行切換時,滾動到頁面頂部;經過前進、後退按鈕進行切換時,保持座標位置
const router = new VueRouter({ mode:'history', routes , 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
}
}
}
下面是一個實例
<div id="app"> <router-view></router-view> <br> <p> <router-link to="/" exact>index</router-link> <router-link :to="{name:'foo' ,hash:'#abc'}">Go to Foo</router-link> <router-link :to="{ name: 'bar' }">Go to Bar</router-link> </p> </div>
const router = new VueRouter({ mode:'history', routes , scrollBehavior (to, from, savedPosition){ if(to.hash){ return { selector: to.hash } } if(savedPosition){ return savedPosition; }else{ return {x:0,y:0} } } })
<router-view>
是基本的動態組件,因此能夠用 <transition>
組件給它添加一些過渡效果:
<transition> <router-view></router-view> </transition>
下面是一個實例
.router-link-active{background:pink;} .v-enter,.v-leave-to{ opacity:0; } .v-enter-active,.v-leave-active{ transition:opacity .5s; }
<div id="app"> <p> <router-link to="/" exact>index</router-link> <router-link :to="{name:'foo'}">Go to Foo</router-link> <router-link :to="{ name: 'bar' }">Go to Bar</router-link> <transition> <router-view></router-view> </transition> </p> </div>
【單個路由過渡】
上面的用法會給全部路由設置同樣的過渡效果,若是想讓每一個路由組件有各自的過渡效果,能夠在各路由組件內使用 <transition>
並設置不一樣的 name
const Foo = {
template: `
<transition name="slide">
<div class="foo">...</div>
</transition>
` } const Bar = { template: ` <transition name="fade"> <div class="bar">...</div> </transition> ` }
定義路由的時候能夠配置 meta
字段:
const router = new VueRouter({
routes: [
{
path: '/foo', component: Foo, children: [ { path: 'bar', component: Bar, meta: { requiresAuth: true } } ] } ] })
routes
配置中的每一個路由對象被稱爲路由記錄。路由記錄能夠是嵌套的,所以,當一個路由匹配成功後,它可能匹配多個路由記錄。例如,根據上面的路由配置,/foo/bar
這個URL將會匹配父路由記錄以及子路由記錄
一個路由匹配到的全部路由記錄會暴露爲 $route
對象(還有在導航鉤子中的 route 對象)的 $route.matched
數組。所以,須要遍歷 $route.matched
來檢查路由記錄中的 meta
字段
下面例子展現在全局導航鉤子中檢查 meta 字段:
router.beforeEach((to, from, next) => {
if (to.matched.some(record => record.meta.requiresAuth)) { if (!auth.loggedIn()) { next({ path: '/login', query: { redirect: to.fullPath } }) } else { next() } } else { next() } })
【基於路由的動態過渡】
能夠基於當前路由與目標路由的變化關係,動態設置過渡效果。經過使用路由元信息,在每一個路由對象上設置一個index屬性保存其索引值
<style> .router-link-active{background:pink;} .left-enter{ transform:translateX(100%); } .left-leave-to{ transform:translateX(-100%); } .left-enter-active,.left-leave-active{ transition:transform .5s; } .right-enter{ transform:translateX(-100%); } .right-leave-to{ transform:translateX(100%); } .right-enter-active,.right-leave-active{ transition:transform .5s; } </style>
<div id="app"> <p> <router-link to="/" exact>index</router-link> <router-link :to="{name:'foo'}">Go to Foo</router-link> <router-link :to="{ name: 'bar' }">Go to Bar</router-link> <transition :name="transitionName"> <router-view></router-view> </transition> </p> </div>
const app = new Vue({
el:'#app',
router,
data () {
return {
'transitionName': 'left'
}
},
watch: {
'$route' (to, from) {
this['transitionName'] = to.meta.index > from.meta.index ? 'right' : 'left';
}
},
})
除了使用<router-link>
建立a標籤來定義導航連接,還能夠藉助router的實例方法,經過編寫代碼來實現
【router.push(location)】
想要導航到不一樣的 URL,則使用 router.push
方法。這個方法會向 history 棧添加一個新的記錄,因此,當用戶點擊瀏覽器後退按鈕時,則回到以前的 URL。
當點擊 <router-link>
時,這個方法會在內部調用,因此說,點擊 <router-link :to="...">
等同於調用 router.push(...)
聲明式 編程式
<router-link :to="..."> router.push(...)
在@click中,用$router表示路由對象,在methods方法中,用this.$router表示路由對象
該方法的參數能夠是一個字符串路徑,或者一個描述地址的對象。例如:
// 字符串 router.push('home') // 對象 router.push({ path: 'home' }) // 命名的路由 router.push({ name: 'user', params: { userId: 123 }}) // 帶查詢參數,變成 /register?plan=private router.push({ path: 'register', query: { plan: 'private' }})
【router.replace(location)
】
跟 router.push
很像,惟一的不一樣就是,它不會向 history 添加新記錄,而是跟它的方法名同樣 —— 替換掉當前的 history 記錄
聲明式 編程式
<router-link :to="..." replace> router.replace(...)
【router.go(n)
】
這個方法的參數是一個整數,意思是在 history 記錄中向前或者後退多少步,相似 window.history.go(n)
// 在瀏覽器記錄中前進一步,等同於 history.forward() router.go(1) // 後退一步記錄,等同於 history.back() router.go(-1) // 前進 3 步記錄 router.go(3) // 若是 history 記錄不夠用,就靜默失敗 router.go(-100) router.go(100)
【操做history】
router.push
、router.replace
和router.go
跟history.pushState、
history.replaceState
和history.go相似
, 實際上它們確實是效仿window.history
API的。vue-router的導航方法(push
、replace
、go
)在各種路由模式(history
、 hash
和abstract
)下表現一致
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()函數傳遞不一樣參數的狀況
next(): 進行管道中的下一個鉤子。若是所有鉤子執行完了,則導航的狀態就是 confirmed (確認的)。 next(false): 中斷當前的導航。若是瀏覽器的 URL 改變了(多是用戶手動或者瀏覽器後退按鈕),那麼 URL 地址會重置到 from 路由對應的地址。 next('/') 或者 next({ path: '/' }): 跳轉到一個不一樣的地址。當前的導航被中斷,而後進行一個新的導航。
[注意]確保要調用 next
方法,不然鉤子就不會被 resolved。
一樣能夠註冊一個全局的 after
鉤子,不過它不像 before
鉤子那樣,after
鉤子沒有 next
方法,不能改變導航:
router.afterEach(route => { // ... })
下面是一個實例
const Home = { template: '<div>home</div>' } const Foo = { template: '<div>Foo</div>'} const Bar = { template: '<div>bar</div>' } const Login = { template: '<div>請登陸</div>' } const routes = [ { path: '/', name:'home', component: Home,meta:{index:0}}, { path: '/foo', name:'foo', component:Foo,meta:{index:1,login:true}}, { path: '/bar', name:'bar', component:Bar,meta:{index:2}}, { path: '/login', name:'login', component:Login,}, ] const router = new VueRouter({ routes , }) router.beforeEach((to, from, next) => { if(to.meta.login){ next('/login'); } next(); }); router.afterEach((to, from)=>{ document.title = to.name; }) const app = new Vue({ el:'#app', router, })
【單個路由獨享】
能夠在路由配置上直接定義 beforeEnter
鉤子
const router = new VueRouter({ routes: [ { path: '/foo', component: Foo, beforeEnter: (to, from, next) => { // ... } } ] })
這些鉤子與全局 before
鉤子的方法參數是同樣的
【組件內鉤子】
能夠在路由組件內直接定義如下路由導航鉤子
beforeRouteEnter beforeRouteUpdate (2.2 新增) beforeRouteLeave
const Foo = { template: `...`, beforeRouteEnter (to, from, next) { // 在渲染該組件的對應路由被 confirm 前調用,不能獲取組件實例 `this`,由於當鉤子執行前,組件實例還沒被建立 }, beforeRouteUpdate (to, from, next) { // 在當前路由改變,可是該組件被複用時調用。舉例來講,對於一個帶有動態參數的路徑 /foo/:id,在 /foo/1 和 /foo/2 之間跳轉時,因爲會渲染一樣的 Foo 組件,所以組件實例會被複用。而這個鉤子就會在這個狀況下被調用。能夠訪問組件實例 `this` }, beforeRouteLeave (to, from, next) { // 導航離開該組件的對應路由時調用,能夠訪問組件實例 `this` } }
beforeRouteEnter
鉤子不能訪問this
,由於鉤子在導航確認前被調用,所以即將登場的新組件還沒被建立
不過,能夠經過傳一個回調給 next
來訪問組件實例。在導航被確認的時候執行回調,而且把組件實例做爲回調方法的參數
beforeRouteEnter (to, from, next) { next(vm => { // 經過 `vm` 訪問組件實例 }) }
能夠在 beforeRouteLeave
中直接訪問 this
。這個 leave
鉤子一般用來禁止用戶在還未保存修改前忽然離開。能夠經過 next(false)
來取消導航
有時候,進入某個路由後,須要從服務器獲取數據。例如,在渲染用戶信息時,須要從服務器獲取用戶的數據。能夠經過兩種方式來實現:
一、導航完成以後獲取:先完成導航,而後在接下來的組件生命週期鉤子中獲取數據。在數據獲取期間顯示『加載中』之類的指示
二、導航完成以前獲取:導航完成前,在路由的 enter
鉤子中獲取數據,在數據獲取成功後執行導航。
從技術角度講,兩種方式都不錯 —— 就看想要的用戶體驗是哪一種
【導航完成後獲取】
當使用這種方式時,會立刻導航和渲染組件,而後在組件的 created
鉤子中獲取數據。有機會在數據獲取期間展現一個 loading 狀態,還能夠在不一樣視圖間展現不一樣的 loading 狀態。
假設有一個 Post
組件,須要基於 $route.params.id
獲取文章數據:
<template> <div class="post"> <div class="loading" v-if="loading"> Loading... </div> <div v-if="error" class="error"> {{ error }} </div> <div v-if="post" class="content"> <h2>{{ post.title }}</h2> <p>{{ post.body }}</p> </div> </div> </template> export default { data () { return { loading: false, post: null, error: null } }, created () { // 組件建立完後獲取數據, // 此時 data 已經被 observed 了 this.fetchData() }, watch: { // 若是路由有變化,會再次執行該方法 '$route': 'fetchData' }, methods: { fetchData () { this.error = this.post = null this.loading = true // replace getPost with your data fetching util / API wrapper getPost(this.$route.params.id, (err, post) => { this.loading = false if (err) { this.error = err.toString() } else { this.post = post } }) } } }
【導航完成前獲取數據】
經過這種方式,在導航轉入新的路由前獲取數據。能夠在接下來的組件的 beforeRouteEnter
鉤子中獲取數據,當數據獲取成功後只調用 next
方法
export default {
data () {
return {
post: null,
error: null
}
},
beforeRouteEnter (to, from, next) {
getPost(to.params.id, (err, post) => {
if (err) {
// display some global error message
next(false)
} else {
next(vm => {
vm.post = post
})
}
})
},
// 路由改變前,組件就已經渲染完了
// 邏輯稍稍不一樣
watch: {
$route () {
this.post = null
getPost(this.$route.params.id, (err, post) => {
if (err) {
this.error = err.toString()
} else {
this.post = post
}
})
}
}
}
在爲後面的視圖獲取數據時,用戶會停留在當前的界面,所以建議在數據獲取期間,顯示一些進度條或者別的指示。若是數據獲取失敗,一樣有必要展現一些全局的錯誤提醒
當打包構建應用時,JS包會變得很是大,影響頁面加載。若是能把不一樣路由對應的組件分割成不一樣的代碼塊,而後當路由被訪問的時候才加載對應組件,這樣就更加高效了
結合 Vue 的 異步組件 和 Webpack 的代碼分割功能,輕鬆實現路由組件的懶加載。
首先,能夠將異步組件定義爲返回一個 Promise 的工廠函數(該函數返回的Promise應該 resolve 組件自己)
const Foo = () => Promise.resolve({ /* 組件定義對象 */ })
在 webpack 2中,使用動態 import語法來定義代碼分塊點(split point):
import('./Foo.vue') // returns a Promise
[注意]若是使用的是 babel,須要添加syntax-dynamic-import插件,才能使 babel 能夠正確地解析語法
結合這二者,這就是如何定義一個可以被 webpack自動代碼分割的異步組件
const Foo = () => import('./Foo.vue')
在路由配置中什麼都不須要改變,只須要像往常同樣使用 Foo
:
const router = new VueRouter({ routes: [ { path: '/foo', component: Foo } ] })
【把組件按組分塊】
有時候想把某個路由下的全部組件都打包在同個異步塊(chunk)中。只須要使用 命名 chunk,一個特殊的註釋語法來提供chunk name(須要webpack > 2.4)
const Foo = () => import(/* webpackChunkName: "group-foo" */ './Foo.vue') const Bar = () => import(/* webpackChunkName: "group-foo" */ './Bar.vue') const Baz = () => import(/* webpackChunkName: "group-foo" */ './Baz.vue')
webpack 會將任何一個異步模塊與相同的塊名稱組合到相同的異步塊中