第4讲 详解如何在项目里配置路由(2)

2020-09-17  本文已影响0人  喔喔牛在路上

上篇文章,我讲了路由里面的,动态路由匹配,编程式导航,嵌套路由匹配,命名路由,命名视图,重定向这几个知识点,但是官网vue-router上,不仅仅是这些内容,我提到的这些知识点是针对于真实的项目开发中用到进行讲解,如果想了解更多vue-router的知识可以查阅官网内容

回忆一下上节的内容,我们在讲动态路由匹配和编程式导航的时候,组件中是如何获取由路由传递过来的值呢?

动态路由匹配:

<template>
    <section>
        {{$route.params.taskId}}
    </section>
</template>

编程式导航:

<template>
    <section>
        {{$route.query.taskId}}
    </section>
</template>

有没有发现,在具体组件里,我们使用的是$route.params$route.query来获取路由传递过来的参数,假如这个组件用到其它路由下面呢,当路由不不携带参数时,组件里有这么个玩意儿$route.query.taskId就会报错,所以,采用上述两种方式,当需要组件复用时,由于路由和组件之间有着高度的耦合,不能最大程度复用组件,那么就需要采用其它方式了,那就是路由组件传参

  1. 路由组件传参

路由组件传参也有3中方式实现:

第1种:布尔模式

修改src/router/index.js里面的路由:

  {
    path: '/task-detail/:taskId',
    name: 'task-detail',
    component: () => import('../views/task-detail.vue'),
    props: true
  },

组件里面获取路由传递过来的值:

<template>
    <section>
        {{taskId}}
    </section>
</template>
<script>
export default {
    props: {
        taskId: {
            type: [String, Number],
            default: ''
        }
    },
    data () {
        return {
            
        }
    }
}
</script>

这样,当需要这个组件复用时,要想给组件传递taskId这个值,只需要调用这个组件即可

<task-detail :taskId="10000218"></task-detail>

通过路由给组件传值的时候要这样写:

<router-link to="/task-detail/10000217">任务详情10000217</router-link>

第2种:对象模式

只需要修改src/router/index.js里面的路由,组件里面和布尔模式一样:

  {
    path: '/task-detail',
    name: 'task-detail',
    component: () => import('../views/task-detail.vue'),
    props: {
      taskId: '10000218'
    }
  },

通过路由给组件传值的时候要这样写:

<router-link to="/task-detail">任务详情10000217</router-link>

第3种:函数模式

只需要修改src/router/index.js里面的路由,组件里面获取值和上面两种一样:

  {
    path: '/task-detail/:taskId',
    name: 'task-detail',
    component: () => import('../views/task-detail.vue'),
    props: route => {
      if (route.params && route.params.taskId) {
        return {
          taskId: route.params.taskId
        }
      }
    }
  },

通过路由给组件传值的时候要这样写:

<router-link to="/task-detail/10000217">任务详情10000217</router-link>
  1. HTML5 History模式

讲这个之前,我先来介绍一个html中锚点的概念,就拿我的写着这个博客来说,一篇文章很长,超过你电脑一屏或者两屏的内容表,例如下面的文章内容:

标题

1. 小标题1

2. 小标题2

3. 小标题3

...

我想快速访问某个小标题的内容,可以这样来写

<a href="#title1">访问小标题1</a>
<a href="#title2">访问小标题1</a>
<a href="#title3">访问小标题1</a>

...

<a name="title1">1. 小标题1</a>
<a name="title2">2. 小标题2</a>
<a name="title3">3. 小标题3</a>
<!--或则-->
<div id="title1">1. 小标题1</a>
<div id="title2">2. 小标题2</a>
<div id="title3">3. 小标题3</a>

这就是锚点的内容,这又和本节内容有什么关系呢?vue-router官方说,vue-router默认hash模式,hash是什么呢?我来介绍一下:

hash属性是一个可读可写的字符串,该字符串是URL的锚部分(从#好开始的部分),#代表网页中的一个位置,其右面的字符就是该位置的标识符(说的就是锚点),例如:

http://www.blog.com/index.html#title1

就代表网页index.html的title1位置,浏览器读取这个URL后会自动将title1位置滚动至可视区域

是用来指导浏览器动作的,对服务器端完全无用,所以,HTTP请求中不包括#,比如访问下面的网址:

http://www.blog.com/index.html#title1

浏览器实际发出的请求是这样的:

GET /index.html HTTP/1.1
Host: www.example.com

可以看到只请求了index.html,根本没有#title1这部分

所以,在URL中,第一个#后面出现的任何字符,都会被浏览器解读为位置标识符(锚点),这些字符都不会被发送到服务器端,而且改变URL中#后面的部分,只相当于改变了锚点,浏览器只会滚动到相应位置,不会重新加载网页,比如:

http://www.blog.com/index.html#title1
到
http://www.blog.com/index.html#title2

这种锚点的改变,完全由浏览器控制,而不会重新向服务器请求index.html这个页面

现在我们再回到vue-router官方文档这里,它提到了,vue-router默认hash模式(#后面跟字符串)使用hash来模拟一个完整的URL,于是当URL改变时,页面不会重新加载,如果不想要这种方式展示,还可以用路由的history模式

const router = new VueRouter({
  mode: 'history',
  routes
})

这样,路由就变化了:

http://localhost:4000/#/task-detail/10000216
变成了
http://localhost:4000/task-detail/10000217

但是这种模式也需要后端的支持,因为我们的应用是个单页客户端应用,只有一个index.html页面,当如有变化时,如果采用hash模式,从路由:

http://localhost:4000/#/task-detail/10000217
变到
http://localhost:4000/#/about

时,不会重新请求页面,至始至终只有一个index.html页面,路由的变化,也可以看成是锚点的改变,显相当于浏览器从#/task-detail这个锚点到/about这个锚点,但是如果采用history模式,从路由:

http://localhost:4000/task-detail/10000217
变成了
http://localhost:4000/about

这个时候浏览器就会认为是需要向服务器请求task-detail.html和about.html这两个html的,但是服务器上根本没有这两个html,就会报404文件未找到错误,所以这个时候就需要后端哥们的支持,未匹配到html页面的时候,就返回index.html这个页面,具体后端怎么配置,可以参考官方文档

  1. 导航守卫

这部分是vue-router部分,在实际项目开发中也很有用处,用来判断用户是否登录,或则有权限访问某一个页面,它帮助我们在路由发生跳转到导航结束这个过程中做一些逻辑处理,我分几个部分来讲

第一种:全局前置守卫

来看下src/router/index.js里的router,这是vue-router的实例,它上面有一个beforeEach方法,功能就是进行全局前置守卫

咱们来看下如何使用:

import Vue from 'vue'
import VueRouter from 'vue-router'
import Home from '../views/Home.vue'
import errorRoutes from './error-router'

Vue.use(VueRouter)

const routes = [
  {
    path: '/',
    name: 'Home',
    component: Home
  },
  {
    path: '/about',
    name: 'About',
    component: () => import(/* webpackChunkName: "about" */ '../views/About.vue')
  },
  {
    path: '/task-detail/:taskId',
    name: 'task-detail',
    component: () => import('../views/task-detail.vue'),
    props: route => {
      if (route.params && route.params.taskId) {
        return {
          taskId: route.params.taskId
        }
      }
    }
  },
  {
    path: '/product',
    name: 'product',
    component: () => import('../views/product/index.vue'),
    children: [
      {
        path: 'ele-product', // 子路由需要前面加'/',只有副路由才有
        name: 'ele-product',
        component: () => import('../views/product/ele-product.vue'),
        children: [
          {
            path: 'phone', // 子路由需要前面加'/',只有副路由才有
            name: 'phone',
            components: {
              default: () => import('../views/product/phone.vue'),
              apple: () => import('../views/product/apple.vue'),
              mi: () => import('../views/product/mi.vue'),
              vivo: () => import('../views/product/vivo.vue'),
            },
          },
          {
            path: 'computer', // 子路由需要前面加'/',只有副路由才有
            name: 'computer',
            component: () => import('../views/product/computer.vue'),
          }
        ]
      }
    ]
  },
  ...errorRoutes,
  {
    path: '*',
    redirect: '/notFound'
  }
]

const router = new VueRouter({
  mode: 'history',
  routes
})

const whitelist = ['login', 'error401', 'error500', 'notFound', 'compatible', 'notLogin', '404', 'abnormal']

let app;
router.beforeEach((to, from, next) => {
    // const isLogin = !!sessionStorage.getItem('accessToken');
    const isLogin = true

    if (isLogin) {
        if (to.name === 'login') {
            next({
                name: 'home'
            });
        } else {
            next()
        }
    } else {
        if (whitelist.indexOf(to.name) !== -1) {
            next()
        } else {
            next({
                name: 'login'
            })
        }
    }
});
// next()方法一定要加,不然不能跳转

router.afterEach((to, from) => {
    app = document.querySelector('.app-content-inner')
    app && app.scrollTo(0, 0)
})

export default router

上面的代码很好读懂,我就不做一一介绍,大概逻辑就是从本地session拿token看是否已经登录,登录了直接跳转到首页,没有登录,看看当前路由是否在白名单那里,不在直接跳转到登录页登录

第二种:全局后置钩子

router实例下的afterEach方法就是全局后置钩子,和前置守卫不同的是,这些钩子不会接受next函数,也不会改变导航本省

第三种:路由独享的守卫

  {
    path: '/about',
    name: 'About',
    component: () => import(/* webpackChunkName: "about" */ '../views/About.vue'),
    beforeEnter: (to, from, next) => {
      if (from.name === 'Home') {
        console.log('从home页跳转过来')
      } else {
        console.log('不是从home页跳转来的')
      }
      next()
    }
  },

第四种: 组件内守卫

beforeRouteEnter

提到这个的时候,想起来前几天做项目遇到一个问题,我有一个创建任务的页面(http://localhost:8082/#/web-task/task-create),分别可以从两个页面:监测任务列表(http://localhost:8082/#/web-task/web-list)和监测任务管理(http://localhost:8082/#/web-task/task-list)跳转过来,需求是,从哪个页面跳转过来的,当任务创建完毕还回到哪个页面

常规思路就是在创建任务的页面监听路由的变化,拿到from.path里的值,也就是上个页面的路由,但是怎么都监听不到路由的变化,这个时候我就想到了beforeRouteEnter使用组件内守卫,可以拿到to和from

beforeRouteEnter (to, from, next) {
    console.log(to.name)
    console.log(from.name)
    console.log(this) // undefined
    next()
}

但是我发现在里面拿不到this这个vue实例,解释原因是因为:走这一步的时候,当前组件还没有渲染完成,vue实例还未创建完成,但是我非要使用肿么办?

解决方法就是给next函数传一个回调函数,完美解决这个问题

beforeRouteEnter (to, from, next) {
  next(vm => {
    if (from.name === 'web_list') {
        vm.from_router = '/web-task/web-list'
    } else if (from.name === 'task_list') {
        vm.from_router = '/web-task/task-list'
    }
  })
}

beforeRouteLeave

关于这个的用法,比如用户在当前页面进行编辑操作,还没有保存就要跳转到其它页面,那么你就可以在这个钩子函数里面提醒用户,编辑还未完成,是否取消编辑,这里提示一下:在这个方法里可以直接用this

<script>
export default {
    props: {
        taskId: {
            type: [String, Number],
            default: ''
        }
    },
    data () {
        return {
            
        }
    },
    methods: {
        
    },
    beforeRouteLeave (to, from, next) {
        const leave = confirm('确定离开吗?')
        if (leave) {
            next()
        } else {
            next(false)
        }
        // next(vm => {
        //     console.log(vm) // vue实例
        // })
    },
    beforeRouteUpdate (to, from, next) {
        console.log('组件被复用')
        next()
    }
}
</script>

beforeRouteUpdate

// 在当前路由改变,但是该组件被复用时调用
// 举例来说,对于一个带有动态参数的路径 /foo/:id,在 /foo/1 和 /foo/2 之间跳转的时候,
// 由于会渲染同样的 Foo 组件,因此组件实例会被复用。而这个钩子就会在这个情况下被调用。
// 可以访问组件实例 `this`
beforeRouteUpdate (to, from, next) {
  console.log('组件被复用')
  next()
}

第五种 路由元信息

{
  path: '/',
  name: 'Home',
  component: Home,
  meta: {
    title: '首页',
    requiresAuth: ['admin', 'user']
  }
},

这里的meta就是元信息,可以在这里给每个路由对象配一个title或者打一个标志,用来区别哪些用户可以访问这个路由

接下来,我讲一个例子,利用前置守卫和路由元信息,修改window.document.title的值

首先找到咱们在第二节新建的src/lib/util.js,当时说了这个文件用来存放和业务相关的方法,接下来咱们就新建一个方法

// util.js
export const setTitle = (title) => {
  window.document.title = title ? title + '-拨测管理平台' : '拨测管理平台'
}

然后在src/router/index.js里面引入,并且在前置守卫里增加一行代码

// router/index.js
import {setTitle} from '@/lib/util'

router.beforeEach((to, from, next) => {
  to.meta && setTitle(to.meta.title)
})

第六种 过渡效果

路由切换的时候,在<router-view>里面加载页面,我们可以利用<transition>组件给它添加一些过渡效果

<transition>
  <router-view></router-view>
</transition>

如果是多个视图,需要用<transition-group>包裹

<transition-group>
  <router-view></router-view>
  <router-view name="phone"></router-view>
</transition-group>

我来写一个过渡效果的例子:

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

<style lang="less">
// 进入效果
.router-enter {
  opacity: 0;
}
.router-enter-active {
  transition: opacity 1s ease;
}
.router-enter-to {
  opacity: 1;
}
// 离开效果
.router-leave {
  opacity: 1;
}
.router-leave-active {
  transition: opacity 1s ease;
}
.router-leave-to {
  opacity: 0;
}
</style>
上一篇下一篇

猜你喜欢

热点阅读