一篇超详细的Vue-Router手把手教程

更新时间：2021年08月09日 15:07:27 作者：鹏多多

这篇文章主要给大家介绍了关于Vue-Router的相关资料,vue-router是Vue.js官方的路由插件,它和vue.js是深度集成的,适合用于构建单页面应用,本文通过示例代码介绍的非常详细,需要的朋友可以参考下

最近在重温vue全家桶，再看一遍感觉记忆更深刻，所以专门记录一下（本文vue-router版本为v3.x）。

1，router-view

<router-view>是一个功能性组件，用于渲染路径匹配到的视图组件。可以配合<transition>和<keep-alive>使用。如果两个一起用，要确保在内层使用<keep-alive>。

<router-view></router-view>
<!--或-->
<router-view name="footer"></router-view>

如果 <router-view>设置了名称，则会渲染对应的路由配置中 components下的相应组件。

2，router-link

<router-link>标签支持用户在具有路由功能的应用中(点击)导航。

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

<router-link :to="{ path: '/login'}" replace tag="span"></router-link>

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

<router-link :to="{name:'Vuex', params: {id: '99999'}}" tag="h1">跳转</router-link>
<!--或者-->
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'
 }
}

跳转

<router-link :to="{name:'Vuex'}" tag="h1">跳转</router-link>
<!--或者-->
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 => ({
     <!--query-->
  id: route.query.id,
  <!--params-->
  age: route.params.age
 }),
 mate: {
  title: 'vuex'
 }
}

跳转

<router-link :to="{name:'Vuex',query: {id: '99999'}, params:{age:'20'}}" tag="h1">跳转</router-link>
<!--或者-->
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属性，实现不同的动画效。

<transition :name="transitionName">
  <router-view></router-view>
</transition>

监听

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

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

总结

到此这篇关于Vue-Router教程的文章就介绍到这了,更多相关Vue-Router手把手教程内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

vue中的inject学习教程
本文通过实例代码给大家介绍了vue中的inject学习教程，非常不错，具有一定的参考借鉴价值，需要的朋友参考下吧
2019-04-04
VUE如何实现点击文字添加颜色(动态修改class)
这篇文章主要介绍了VUE如何实现点击文字添加颜色(动态修改class),具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2023-11-11
vue实现自定义树形组件的示例代码
这篇文章主要介绍了vue实现自定义树形组件的示例代码,本文通过示例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
2023-08-08
记录vue做微信自定义分享的一些问题
这篇文章主要介绍了记录vue做微信自定义分享的一些问题，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2019-09-09
五分钟理解keep alive用法及原理
这篇文章主要为大家介绍了keep alive用法及原理示例解析，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2022-07-07
带你熟练掌握Vue3之Pinia状态管理
pinia是vue3官方的状态管理工具,当然vue2也可以用,vue2中的状态管理工具是vuex,vue3中不再使用vuex,推荐使用的是pinia,和vuex差不多,但比vuex更方便、更强、更好,下面这篇文章主要给大家介绍了关于Vue3之Pinia状态管理的相关资料,需要的朋友可以参考下
2022-11-11
什么是Vue.js框架为什么选择它？(第一课)
Vue.js框架是什么，为什么要选择它？这篇文章为大家介绍目前前端技术使用的趋势，以及Vue.js的优点和适用场景等，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2017-10-10
vue3.0 CLI - 2.1 - component 组件入门教程
这篇文章主要介绍了vue3.0 CLI - 2.1 - component 组件入门教程,本文主要的关注点就是组件，本文通过实例代码相结合的形式给大家介绍的非常详细，需要的朋友可以参考下
2018-09-09
Vue render深入开发讲解
这篇文章主要介绍了Vue render深入开发讲解
2018-04-04
如何使用RoughViz可视化Vue.js中的草绘图表
这篇文章主要介绍了如何使用RoughViz可视化Vue.js中的草绘图表，帮助大家更好的理解和使用roughViz，感兴趣的朋友可以了解下
2021-01-01