超详细！Vue-Router手把手教程超详细！Vue-Router手把手教程

最近在重温vue全家桶，再看一遍感觉记忆更深刻，所以专门记录一下（本文vue-router版本为v3.x）。
1，router-view 是一个功能性组件，用于渲染路径匹配到的视图组件。可以配合和使用。如果两个一起用，要确保在内层使用。

如果设置了名称，则会渲染对应的路由配置中 components下的相应组件。
2，router-link 标签支持用户在具有路由功能的应用中(点击)导航。

属性	类型	说明
to	String/Object	目标路由/目标位置的对象
replace	Boolean	不留下导航记录
append	Boolean	在当前路径后加路径 /a => /a/b
tag	String	指定渲染成何种标签
active-class	String	激活时使用的Class

3，重定向redirect 根路由重定向到login

const router = new VueRouter({ routes: [ { path: '/', redirect: '/login' } ] })

动态返回重定向目标

const router = new VueRouter({ routes: [ { path: '/a', redirect: to => { // 方法接收目标路由作为参数 // return 重定向的字符串路径/路径对象 }} ] })

4，路由别名路由访问/b时，URL会保持为/b，但是路由匹配则为/a

const router = new VueRouter({ routes: [ { path: '/a', component: A, alias: '/b' } ] })

5，路由传参props 使用props，避免和$route过度耦合，这样就可以直接在组件中使用props接收参数
5.1，布尔模式在路由后面写上参数，并设置props为true

{ path: '/vuex/:id', name: 'Vuex', component: () => import('@/view/vuex'), props: true, mate: { title: 'vuex' } }

设置跳转需要传递的参数params

跳转toNext() { this.$router.push({ name: 'Vuex', params: { id: '99999' } }) }

在跳转过去的页面，通过props或者this.$params取参

props: { id: { type: String, default: '' } }this.$params.id

5.2，对象模式在路由中设置props为对象，携带静态数据

{ path: '/vuex', name: 'Vuex', component: () => import('@/view/vuex'), props: { id: '99999' }, mate: { title: 'vuex' } }

【超详细！Vue-Router手把手教程】跳转

跳转toNext() { this.$router.push({ name: 'Vuex' }) }

在跳转过去的页面，通过props或者this.$params取参

props: { id: { type: String, default: '' } }this.$params.id

注意：只适用于静态数据
5.3，函数模式先在路由中设置props为Function，return一个对象，不管是query传参还是params传参，都可以转为props

{ path: '/vuex', name: 'Vuex', component: () => import('@/view/vuex'), props: route => ({id: route.query.id,age: route.params.age }), mate: { title: 'vuex' } }

跳转

跳转toNext() { this.$router.push({ name: 'Vuex', query: { id: '999999' }, params: { age: '20' } }) }

在跳转过去的页面，通过props或者this.$route.params / this.$route.query取参

props: { id: { type: String, default: '' }, age: { type: String, default: '' } }this.$route.query this.$route.params

6，路由守卫路由守卫主要用来通过跳转或取消的方式守卫导航。
6.1，全局前置守卫beforeEach 当一个导航触发时，全局前置守卫按照创建顺序调用。守卫是异步解析执行，此时导航在所有守卫解析完之前一直处于等待中。

参数	说明
to	即将要进入的目标路由对象
from	当前导航正要离开的路由
next	回调方法

next用法如下

语法	说明
next()	进行下一个钩子
next(false)	中断导航，URL如已改，则重置到from的地址
next('/')	中断当前跳转并到其他地址，可设置路由对象
next(error)	导航终止并传递错误给onError()

const router = new VueRouter({ ... })router.beforeEach((to, from, next) => { // ... })

6.2，全局解析守卫beforeResolve 2.5.0新增，和beforeEach类似，区别是在导航被确认之前，同时在所有组件内守卫和异步路由组件被解析之后，解析守卫就被调用。

router.eforeResolve((to, from, next) => { // ... })

6.3，全局后置钩子afterEach 后置守卫不会接受next函数也不会改变导航本身

router.afterEach((to, from) => { // ... })

6.4，路由独享守卫beforeEnter 可以在路由配置上直接定义专属的beforeEnter守卫，与全局前置守卫的方法参数是一样的。

const router = new VueRouter({ routes: [ { path: '/foo', component: Foo, beforeEnter: (to, from, next) => { // ... } } ] })

6.5，组件内的守卫

beforeRouteEnter

该守卫不能访问this，因为守卫在导航确认前被调用，因此即将登场的新组件还没被创建。可以通过传一个回调给next来访问组件实例。在导航被确认的时候执行回调，并且把组件实例作为回调方法的参数。

const Footer = { template: `...`, beforeRouteEnter(to, from, next) { next(vm => { // 通过 `vm` 访问组件实例 }) } }

beforeRouteUpdate (2.2 新增)

在当前路由改变，但是该组件被复用时调用，可以访问组件实例this。

const Foo = { template: `...`, beforeRouteUpdate(to, from, next) { this.name = to.params.name next() } }

beforeRouteLeave

导航离开该组件的对应路由时调用，通常用来禁止用户在还未保存修改前突然离开。可以通过next(false)来取消。

const Foo = { template: `...`, beforeRouteLeave(to, from, next) { const answer = window.confirm('确认要离开吗') if (answer) { next() } else { next(false) } } }

6.6，完整的导航解析流程

导航被触发。
在失活的组件里调用beforeRouteLeave守卫。
调用全局的beforeEach守卫。
在重用的组件里调用beforeRouteUpdate守卫 (2.2+)。
在路由配置里调用beforeEnter。
解析异步路由组件。
在被激活的组件里调用beforeRouteEnter。
调用全局的beforeResolve守卫(2.5+)。
导航被确认。
调用全局的afterEach钩子。
触发DOM更新。
调用beforeRouteEnter守卫中传给next的回调函数，创建好的组件实例会作为回调函数的参数传入。

7，路由元信息定义路由的时候可以配置meta对象字段，用来存储每个路由对应的信息。通过this.$route.meta来访问，或者在路由守卫中通过to.meta和from.meta访问。

const router = new VueRouter({ routes: [ { path: '/index', name: 'Index', component: () => import('@/view/index'), meta: { title: '首页', rolu: ['admin', 'boss'] } } ] })

8，过渡动效只需要使用transition标签包裹住router-view标签即可，动画效果可以自己定义，参考transition组件的用法。也可以在父组件或者app.js中使用watch监听$route变化，根据不同路由替换transition组件的name属性，实现不同的动画效。

监听

watch: { '$route' (to, from) { const toD = to.path.split('/').length const fromD = from.path.split('/').length this.transitionName = toD < fromD ? 'slide-right' : 'slide-left' } }

9，滚动行为当创建Router实例时，可以提供一个scrollBehavior方法，并接收to和from路由对象。第三个参数savedPosition只有通过浏览器的前进/后退按钮触发时才可用。

const router = new VueRouter({ mode: 'hash', routes, scrollBehavior(to, from, savedPosition) { if (savedPosition) { return new Promise((resolve, reject) => { setTimeout(() => { resolve(savedPosition) }, 1000) }) } else { return { x: 0, y: 0 } } } })

10，完整路由配置首先导入Vue和vue-router，然后使用router，定义路由信息集合，每个路由都是一个对象，对象拥有如下属性

属性	类型	值
path	String	组件路径信息
name	String	组件命名
component	Function	组件
mate	Object	元信息
children	Object	子路由
redirect	String	重定向
props	Boolean/Object/Function	参数传递

具体代码如下：

import Vue from 'vue' import VueRouter from 'vue-router' Vue.use(VueRouter)const routes = [ { path: '/', redirect: '/index' }, { path: '/index', name: 'Index', component: () => import(/* webpackChunkName: "index" */ '@/view/index'), mate: { title: '首页', auth: false } }, { path: '/login', name: 'Login', component: () => import(/* webpackChunkName: "login" */ '@/view/login'), meta: { title: '登录', auth: false }, children: [ { path: 'children', name: 'Children', component: () => import(/* webpackChunkName: "children" */ '@/view/children'), mate: { title: '嵌套的子路由', auth: false } } ] } ]const router = new VueRouter({ mode: 'hash', routes })export default router

注意：嵌套子路由必须在被嵌套的页面放置标签。