虽然Vue.js未提供路由功能,但是官方推出了Vue Router(即vue-router库),以插件的形式支持。它与Vue.js深度集成,可快速的创建单页应用(Single Page Application,SPA)。

一、基本用法

  首先需要引入vue和vue-router两个库,如果像下面这样全局引用(即存在全局变量Vue),那么vue-router会自动调用Vue.use()方法注册其自身;但如果以模块的方式引用,那么就得显式地调用Vue.use()。

<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组件所占的位置无任何内容。

<div id="container">
  <a href="#/main" class="">首页</a>
  <a href="#/list" class="">列表</a>
</div>

  当router-link组件所对应的路由匹配成功时,其渲染出的元素会被自动添加一个CSS类:router-link-active。例如点击首页链接,得到的结构如下所示,注意,此时router-view组件被替换成了Main组件中的内容。

<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参数的回调函数。

 

版权声明:本文为strick原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
本文链接:https://www.cnblogs.com/strick/p/11495419.html