Vue Router 的使用

64 阅读4分钟

Vue Router 是Vue.js的官方路由:

  • 它与Vue.js核心深度集成,让用Vue.js构成单页面应用(SPA)变得非常容易

Vue Router 是基于路由和组件的

  • 路由用于设定访问路径,将路径和组件映射起来
  • 在vue-router的单页面应用中,页面的路径的改变就是组件的切换

安装Vue Router

npm install vue-router

路由的使用步骤

  1. 创建路由需要的映射的组件 (打算显示的页面)
  2. 通过createRouter创建路由对象,并传入routeshistory模式;
    1. 配置路由映射:组件和路径映射关系的routes数组
    2. 创建基于hash或者history的模式
  3. 使用App注册路由对象(use方法)
  4. 通过使用: 通过<router-link>和<router-view>

image.png

image.png

image.png

image.png

默认的路由路径

  • 默认没有显示首页组件,必须让用户点击才可以,如何让路径默认跳到首页,并且渲染首页组件呢?
const routes = [
    { path: "/", redirect: '/home},
    { path: "/home", component: Home},
    { path: "/about, component: About}
]
  • 在routes中配置了一个映射
    1. path配置的是根路径: /
    2. redirect是重定向,将根路径重定向到/home路径下,这样就可得到想要的结果

router-linke

  • router-linke 属性配置
  • to 属性: 是一个字符串,或者是一个对象
  • replace 属性: 设置replace 属性的话,当点击时,会调用router.replace(), 而不是router.push();
  • active-class 属性: 设置激活a元素后应用的class,默认是router-link-active
  • exact-active-class属性:链接精准激活时,应用于渲染的class, 默认是router-link-exact-active

路由懒加载

  • 当打包构建应用时,JavaScript 包会变得非常大,影响页面加载:
    • 如果能把不同路由对应的组件分割成不同的代码块,然后当路由被访问的时候才加载对应组件,这样会更加高效
    • 也可以提高首屏的渲染效率
  • Vue Router 默认就支持动态来导入组件:
    • component 可以传入一个组件,也可以接收一个函数,该函数 需要返回一个Promise;
    • 而 import 函数就是返回一个Promise;

路由的其他属性

  • name属性: 路由记录独一无二的名称
  • meta属性:自定义的数据

动态路由的基本匹配

  • 很多时候我们需要将给定匹配模式的路由映射到同一个组件:
    • 例如,我们可能有一个User组件,它应对所有用户进行渲染,但是用户的ID是不同的;
    • 在Vue Router中,我们可以在路径中使用一个动态字段来实现,我们称之为 路径参数;
     {
         path: '/user/:id',
         component: () => import('../view/User.vue')
     }
    
  • 在router-link中进行如下跳转:
    <router-link to="/user/123">用户:123</router-link>
    

获取动态路由的值

  • 在User中如何获取到对应的值呢?
    • 在template中,直接通过$route.params获取值
    • 在setup中,我们要使用vue-router库给我们提供一个hook useRoute
      该Hook会防护一个Route对象, 对象中保存着当前路由相关的值
    <template>
        <div>
           <h2>用户界面:: {{ $route.params.id }}</h2>
        </div>
    </template>
    export default {
    create() {
        console.log(this.$route.params.id)
    },
    setup () {
        const route = useRoute()
        console.log(route)
        console.log(route.params.id)
    }

NotFound

  • 对于那些没有匹配到的的路由,我们通常会匹配到固定的某个页面
    • 比如NotFound的错误页面中,这个时候我们可编写一个动态路由用于匹配所有的页面
    {
        path: '/:pathMatch(.*)',
        component: () => import('../pages/NotFound.vue')
    }
    
  • 可以通过$route.params.pathMatch获取到传入的参数:

    Not Found: user/hahah/123

   <h2>Not Found: {{ $route.params.pathMatch }}</h2>

匹配规则加*

  • 这里还有另外一种写法
    {
        path: '/:pathMatch(.*)*',
        component: () => import('../pages/NotFound.vue')
    }
    
  • 它们的区别在于解析的时候,是否解析 /:
    • Not Found:["user","hahah", "123"] path: '/:pathMatch(.*)*',
    • Not Found: user/hahah/123 path:'/:pathMatch(.*)',

路由的嵌套

  • 什么是路由的嵌套呢?
    • 路由的嵌套,也可以称为“父子路由”,即在一个路由中又包含了另一个路由。

路由嵌套的配置

 {
     path: '/home',
     component: () => import('../pages/Home.vue'),
     children: [
     {
         path: '',
         redirect: '/home/product'
     },
     {
         path: 'product',
         component: () => import('../pages/HomeProduct.vue')
     },
     {
         path: 'message',
         component: () => import('../pages/HomeMessage.vue')
     }
   ]
 }

代码的页面跳转

  • 有时候我们希望通过代码来完成页面的跳转,比如点击的是一个按钮
    jumpToProfile() {
        jumpToProfile() {
            this.$router.push('/profile')
     }
    }
    
  • 当然,也可以是传入一个对象
    jumpToProfile() {
         this.$router.push({
            path: '/profile'
        })
    }
    
  • 如果是在setup中编写的代码,那么可以通过useRouter 来获取
    import { useRouter } from 'vue-router'
    
    const router = useRouter()
    const jumpToProfile = () => {
        router.replace('/profile')
    }
    

动态添加路由

  • 某些情况下可能需要动态的来添加路由:
    • 比如根据用户不同的权限,注册不同的路由
    • 这个·时候我们可以使用一个方法addRoute
  • 如果我们是为route添加一个children路由,那么可以传入对应的name
const addRouteOne = {
      path:'/addone'
      component: () => import('../pages/AddOne')
  }
 router.addRoute(addRouteOne)
const addRouteOne = {
      path:'/addone'
      component: () => import('../pages/AddOne')
  }
 router.addRoute('home', addRouteOne)
  • 路由其他方法补充
    • router.hasRoute():检查路由是否存在
    • router.getRoutes(): 获取一个包含所有路由记录的数组

路由导航守卫

  • next.router.vuejs.org/zh/guide/ad…
  • vue-router提供的导航守卫主要用来通过跳转或取消的方式守卫导航
  • 全局的前置守卫beforeEach是在导航触发时会被回调的
  • 它有两个参数:
    • to: 即将进入的路由Route对象
    • from: 即将离开的路由Route对象
  • 它有返回值
    • false: 取消当前导航;
    • 不返回或者undefined:进行默认导航
    • 返回一个路由地址
      • 可以是一个string类型的路径
      • 可以是一个对象,对象包含path、query、params等信息
  • 可选的第三个参数:next(不推荐使用)
    • 在Vue2中对我们是通过next函数来决定如何进行跳转的
    • 但是在Vue3中我们是通过放回值来控制的,不再推荐使用next函数,这是因为开发中很多容易调用多次next;

登录守卫功能

  • 只有登录后才能看到其他页面
  router.beforeEach((to, from) => {
      if(to.path !== '/login') {
      const token = window.localStorage.getItem('token')
      if (!token) {
          return {
              path: '/login'
          }
      }
   }
  })
  export default {
      setup() {
          const router = useRouter()
          const login = () => {
              window.localStorage.setItem('token', '123')
              router.push({
                  path: '/home'
              })
          }
          return {
              login
          }
      }
  }