虽然Vue.js未提供路由功能,可是官方推出了Vue Router(即vue-router库),以插件的形式支持。它与Vue.js深度集成,可快速的建立单页应用(Single Page Application,SPA)。vue
首先须要引入vue和vue-router两个库,若是像下面这样全局引用(即存在全局变量Vue),那么vue-router会自动调用Vue.use()方法注册其自身;但若是以模块的方式引用,那么就得显式地调用Vue.use()。vue-router
<script src="js/vue.js"></script> <script src="js/vue-router.js"></script>
而后添加两个内置的组件,第一个是导航用的router-link组件,它默认会被渲染成<a>元素,若是要渲染成其它元素,那么可使用它的tag属性;第二个是路径匹配时用于渲染视图的router-view组件,它仍是一个函数式组件,以下所示。编程
<div id="container"> <router-link to="/main">首页</router-link> <router-link to="/list">列表</router-link> <router-view></router-view> </div>
再声明要渲染的组件,这些组件会与指定的路由映射,下面是两个很是简单的自定义组件。浏览器
const Main = { template: '<div>首页</div>' };
const List = { template: '<div>列表</div>' };
接着定义路由配置,添加一组路径以及对应的组件,以下所示。服务器
const routes = [ { path: '/main', component: Main }, { path: '/list', component: List } ];
最后建立路由器实例,并将以前的路由配置传递进来,在挂载根实例时,须要将它注入,从而让整个应用都有路由功能,以下所示。异步
const router = new VueRouter({ routes: routes }); var vm = new Vue({ el: "#container", router: router });
注意,router实例包含三个导航方法:push()、replace()和go(),能够用编程的方式进行导航。函数
页面在渲染完成后,获得的DOM结构以下所示,此时router-view组件所占的位置无任何内容。this
<div id="container"> <a href="#/main" class="">首页</a> <a href="#/list" class="">列表</a> </div>
当router-link组件所对应的路由匹配成功时,其渲染出的元素会被自动添加一个CSS类:router-link-active。例如点击首页连接,获得的结构以下所示,注意,此时router-view组件被替换成了Main组件中的内容。spa
<div id="container"> <a href="#/main" class="router-link-active">首页</a> <a href="#/list" class="">列表</a> <div>首页</div> </div>
Vue Router默认采用URL hash模式来保持页面和URL的同步,其建立的URL格式须要包含井号(#),以下所示。插件
http://pwstrick.com/#/main
Vue Router还有另一种history模式,利用HTML5 History来保持页面和URL的同步,其建立的URL格式在视觉上更为简洁清晰,以下所示。
http://pwstrick.com/main
若是要开启history模式,那么须要在路由配置时添加mode选项,并赋予history关键字,以下所示(直接修改了上一节中的示例)。
const router = new VueRouter({ mode: "history", routes: routes });
注意,当直接访问history模式建立的URL时,会返回一个404页面。为了不这种状况的发生,建议在服务器上配置一个默认的候选页面。
本节不只会介绍动态路由的概念,还会分析路由的命名和嵌套等操做。
1)动态路由
Vue Router采用的路径匹配引擎是path-to-regexp,它支持动态路由的匹配,例若有一个List组件,须要根据路径中的页码参数把组件渲染成不一样的内容,能够像下面这样配置。
const List = { template: '<div>{{$route.params.page}}</div>' }; const routes = [ { path: '/list/:page', component: List } ];
在路由配置中,以冒号开头的:page是路径参数,它的值会被保存到路由对象$route的params属性中。路由对象不只包含解析URL获得的信息(例如路径、查询字符串、锚点等),还有匹配到的路由信息(例如路由名称、路由记录等)。当路径是/list/1时,$route.params的值为{page: 1},params是一个对象,其键值与路径参数对应。注意,一条路径能够包含多个不一样的路径参数。
当一个路径能匹配多个路由时,匹配优先级会按照路由的定义顺序来排,即先定义的,优先级高。下面的配置包含两个路由,当路径是/list/1时,只会渲染List组件。
const routes = [ { path: '/list/:page', component: List }, { path: '/list/1', component: Main } ];
2)命名路由
能够在配置时为路由标识一个名称,从而就能在使用时省略路径了,以下所示,name属性的值就是路由名称。
const routes = [ { path: '/list/:page', component: List, name: "list" } ];
若是要导航到一个命名路由,那么须要动态地绑定to属性,并为其传入路由的名称以及可选的URL参数,以下所示。
<router-link :to="{ name: 'list', params: {page: 3} }">第三页</router-link>
3)嵌套路由
Vue Router容许嵌套路由,可经过多层嵌套的组件实现。下面是一个使用示例,首先在一个组件中声明router-view视图组件,以下所示。
const List = { template: '<router-view></router-view>' };
const Detail = { template: '<div>详情</div>' };
而后在路由配置中,添加children选项,并定义子路由。
const routes = [ { path: "/list", component: List, children: [{ path: "detail", component: Detail }] } ];
在通过这一系列操做后,当路径是/list/detail时,Detail组件就会被渲染到List组件的视图中。
嵌套路由可用来渲染多个不一样层级的视图,而利用命名视图可渲染多个同级的视图。在下面的代码中,为第二个router-view组件添加了name属性,赋予它一个名称,而第一个router-view组件的默认名称为default。
<router-view></router-view> <router-view name="detail"></router-view>
在路由配置时,新增用于记录各个命名组件的components选项,以下所示。
const routes = [ { path: "/named", components: { default: Main, detail: Detail } } ];
当路径是/named时,Main和Detail两个组件会被同时渲染。
1)重定向
在路由配置中,经过redirect选项可重定向到一个新的页面,该选项可取的值有三种,分别是路径、命名路由和回调函数,以下所示,其中函数中的to参数表示目标路由对象。
const routes = [ { path: "/list/1", redirect: "/main" }, { path: "/list/1", redirect: {name: "main"} }, { path: "/list/1", redirect: to => "/main" } ];
当访问的路径是/list/1时,浏览器的地址栏会变成/main,匹配的将是路径为/main的路由。
2)别名
在路由配置中,经过alias选项可定义路由的别名,以下所示。
const routes = [ { path: "/list/4", component: Detail, alias: "/detail" } ];
当访问的路径是/main时,浏览器的地址栏保持为/main,但匹配的将是路径为/list/4的路由。
除了在组件中经过$route.params获取路由参数以外,还能将路由参数做为组件的props传入,从而将组件和路由解耦,以下所示。
const List = { props: ["page"], template: "<div>{{page}}</div>" }; const routes = [ { path: "/list/:page", component: List, props: true } ];
须要注意的是,在路由配置时要添加props选项,并赋予true后,才会让路由参数和props关联。
导航守卫就是路由发生变化时的钩子函数,Vue Router提供了三类守卫:全局、路由独享和组件级。
1)全局守卫
在路由器实例上可注册三个全局守卫,分别是beforeEach()、beforeResolve()和afterEach()。
beforeEach()是一个全局前置守卫,包含三个参数(以下所示),其中to是目标路由对象、from是来源路由对象,next是一个回调函数,用于解析(resolve)当前守卫。
router.beforeEach((to, from, next) => {
next();
});
因为导航在全部守卫解析以前会处于等待状态(即不会改变路径,也不会渲染对应的组件),所以在回调中不能省略next()函数。注意,该函数不只能处理导航,还能将其中断或重定向,甚至注册一个错误。
beforeResolve()是一个全局解析守卫,其参数和beforeEach()的相同,在导航被确认前,而且组件内的守卫和异步路由组件被解析以后调用。afterEach()是一个全局后置守卫,它只有to和from两个参数。
2)路由守卫
在路由配置中可直接定义beforeEnter()守卫,做用于某个单独的路由而非全局,其参数和beforeEach()的相同,以下所示。
const routes = [ { path: "/list", component: List, beforeEnter: (to, from, next) => { next(); } } ];
3)组件守卫
组件内的导航守卫包含三个,以下所列,它们的参数都和beforeEach()的相同,也是to、from和next。
(1)beforeRouteEnter():因为该组件在导航确认前被调用,所以组件还未被建立,从而访问this没法获得组件实例。但next()函数能接收一个参数为组件实例的回调,以下所示。
const List = { beforeRouteEnter: function(to, from, next) { next(vm => { //vm是组件实例 }); } };
(2)beforeRouteUpdate():可经过this获得组件实例,当路由发生变化,但复用了一个组件时,会调用该守卫。例如一个路径为/list/:page的路由(以下配置所示),在将/list/1导航至list/2时,因为渲染的都是List组件,所以会调用beforeRouteUpdate()守卫。
const routes = [ { path: "/list/:page", component: List } ];
(3)beforeRouteLeave():也可经过this获得组件实例,当路由改变,而且渲染的组件不一样时,会调用该守卫。例若有两条路径/main和/list,分别对应Main和List组件,在List组件中声明了beforeRouteLeave()守卫(以下所示),当从/list导航至/main时,会弹出确认框,判断是否须要取消本次导航。
const List = { beforeRouteLeave: function(to, from, next) { const answer = window.confirm("是否离开当前页?"); answer ? next() : next(false); } };
4)解析流程
完整的导航解析流程以下所列。
(1)导航被触发。
(2)在失活的组件里调用beforeRouteLeave()守卫。
(3)调用全局的beforeEach()守卫。
(4)在重用的组件里调用beforeRouteUpdate()守卫。
(5)在路由配置里调用beforeEnter()守卫。
(6)解析异步路由组件。
(7)在被激活的组件里调用beforeRouteEnter()守卫。
(8)调用全局的beforeResolve()守卫。
(9)导航被确认。
(10)调用全局的afterEach()守卫。
(11)触发DOM更新。
(12)用建立好的实例调用beforeRouteEnter()守卫中传给next参数的回调函数。