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

编辑: admin 分类: javascript 发布时间: 2022-01-01 来源:互联网
目录
  • 1,router-view
  • 2,router-link
  • 3,重定向redirect
  • 4,路由别名
  • 5,路由传参props
    • 5.1,布尔模式
    • 5.2,对象模式
    • 5.3,函数模式
  • 6,路由守卫
    • 6.1,全局前置守卫beforeEach
    • 6.2,全局解析守卫beforeResolve
    • 6.3,全局后置钩子afterEach
    • 6.4,路由独享守卫beforeEnter
    • 6.5,组件内的守卫
    • 6.6,完整的导航解析流程
  • 7,路由元信息
    • 8,过渡动效
      • 9,滚动行为
        • 10,完整路由配置
          • 总结

            最近在重温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,完整的导航解析流程

            1. 导航被触发。
            2. 在失活的组件里调用beforeRouteLeave守卫。
            3. 调用全局的beforeEach守卫。
            4. 在重用的组件里调用beforeRouteUpdate守卫 (2.2+)。
            5. 在路由配置里调用beforeEnter。
            6. 解析异步路由组件。
            7. 在被激活的组件里调用beforeRouteEnter。
            8. 调用全局的beforeResolve守卫(2.5+)。
            9. 导航被确认。
            10. 调用全局的afterEach钩子。
            11. 触发DOM更新。
            12. 调用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'),
             【文章出处:cc防御 转载请说明出处】 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手把手教程内容请搜索hwidc以前的文章或继续浏览下面的相关文章希望大家以后多多支持hwidc!

            【文章由:韩国高防服务器 提供,感谢支持】