Vue3_Router

# Vue_Router

Router

认识前端路由

• 路由其实是网络工程中的一个术语：

  • 在架构一个网络时，非常重要的两个设备就是路由器和交换机。
  • 当然，目前在我们生活中路由器也是越来越被大家所熟知，因为我们生活中都会用到路由器：
  • 事实上，路由器主要维护的是一个映射表；
  • 映射表会决定数据的流向；

• 路由的概念在软件工程中出现，最早是在后端路由中实现的，原因是 web 的发展主要经历了这样一些阶段：

  • 后端路由阶段；
  • 前后端分离阶段；
  • 单页面富应用（SPA）；

后端路由阶段

• 早期的网站开发整个 HTML 页面是由服务器来渲染的.
  • 服务器直接生产渲染好对应的 HTML 页面, 返回给客户端进行展示.
• 但是, 一个网站, 这么多页面服务器如何处理呢?
  • 一个页面有自己对应的网址, 也就是 URL；
  • URL 会发送到服务器, 服务器会通过正则对该 URL 进行匹配, 并且最后交给一个 Controller 进行处理；
  • Controller 进行各种处理, 最终生成 HTML 或者数据, 返回给前端.
• 上面的这种操作, 就是后端路由：
  • 当我们页面中需要请求不同的路径内容时, 交给服务器来进行处理, 服务器渲染好整个页面, 并且将页面返回给客户端.
  • 这种情况下渲染好的页面, 不需要单独加载任何的 js 和 css, 可以直接交给浏览器展示, 这样也有利于 SEO 的优化.
• 后端路由的缺点:
  • 一种情况是整个页面的模块由后端人员来编写和维护的；
  • 另一种情况是前端开发人员如果要开发页面, 需要通过 PHP 和 Java 等语言来编写页面代码；
  • 而且通常情况下 HTML 代码和数据以及对应的逻辑会混在一起, 编写和维护都是非常糟糕的事情；

前后端分离阶段

• 前端渲染的理解：
  • 每次请求涉及到的静态资源都会从静态资源服务器获取，这些资源包括 HTML+CSS+JS，然后在前端对这些请求回来的资源进行渲染；
  • 需要注意的是，客户端的每一次请求，都会从静态资源服务器请求文件；
  • 同时可以看到，和之前的后端路由不同，这时后端只是负责提供 API 了；
• 前后端分离阶段：
  • 随着 Ajax 的出现, 有了前后端分离的开发模式；
  • 后端只提供 API 来返回数据，前端通过 Ajax 获取数据，并且可以通过 JavaScript 将数据渲染到页面中；
  • 这样做最大的优点就是前后端责任的清晰，后端专注于数据上，前端专注于交互和可视化上；
  • 并且当移动端 (iOS/Android) 出现后，后端不需要进行任何处理，依然使用之前的一套 API 即可；
  • 目前比较少的网站采用这种模式开发；

单页面富应用阶段

• 单页面富应用阶段:
  • 其实 SPA 最主要的特点就是在前后端分离的基础上加了一层前端路由.
  • 也就是前端来维护一套路由规则.
• 前端路由的核心是什么呢？改变URL，但是页面不进行整体的刷新。

URL的hash

• 前端路由是如何做到 URL 和内容进行映射呢？监听 URL 的改变。

• URL 的 hash

  • URL 的 hash 也就是锚点(#), 本质上是改变 window.location 的 href 属性；
  • 我们可以通过直接赋值 location.hash 来改变 href, 但是页面不发生刷新；

• hash 的优势就是兼容性更好，在老版 IE 中都可以运行，但是缺陷是有一个 #，显得不像一个真实的路径。

HTML5 的 History

• history 接口是 HTML5 新增的, 它有六种模式改变 URL 而不刷新页面：
  • replaceState：替换原来的路径；
  • pushState：使用新的路径；
  • popState：路径的回退；
  • go：向前或向后改变路径；
  • forward：向前改变路径；
  • back：向后改变路径；

认识vue-router

• 目前前端流行的三大框架, 都有自己的路由实现:
  • Angular 的 ngRouter
  • React 的 ReactRouter
  • Vue 的 vue-router
• Vue Router 是 Vue.js 的官方路由：
  • 它与 Vue.js 核心深度集成，让用 Vue.js 构建单页应用（SPA）变得非常容易；
  • 目前 Vue 路由最新的版本是 4.x 版本，我们上课会基于最新的版本讲解；
• vue-router 是基于路由和组件的
  • 路由用于设定访问路径, 将路径和组件映射起来；
  • 在 vue-router 的单页面应用中, 页面的路径的改变就是组件的切换；
• 安装 Vue Router： npm install vue-router

路由的使用步骤

• 使用 vue-router 的步骤:
  • 第一步：创建路由需要映射的组件（打算要显示的页面）；
  • 第二步：通过 createRouter 创建路由对象，并且传入 routes 和 history 模式；
    • 配置路由映射: 组件和路径映射关系的 routes 数组；
    • 创建基于 hash 或者 history 的模式；
• 第三步：使用 app 注册路由对象（use 方法）；
• 第四步：路由使用: 通过 <router-link>和<router-view>；

路由的使用流程

• 01 配置路由映射表: ./src/router/index.js :

// 创建路由映射表

// 1.1 导入方法
import {
  createRouter,
  createWebHashHistory,
  createWebHistory,
} from "vue-router";

// 1.2 导入组件
import Home from "../Views/Home.vue";
import About from "../Views/About.vue";

// 1.3 创建路由配置信息
const router = createRouter({
  // history: createWebHashHistory(), // hash 模式 ,url带有 # 号分隔
  history: createWebHistory(), // history 模式, url不带有 # 号
  routes: [
    //映射表  redirect:路由重定向
    { path: "/", redirect: "/home" },
    { path: "/home", component: Home },
    { path: "/about", component: About },
  ],
});

// 1.4 暴露路由配置对象
export default router;

• 02 注册路由配置信息: ./src/main.js

import { createApp } from "vue";
import App from "./App.vue";

// 2.1 导入路由配置信息
import router from "./router";

const app = createApp(App);

// 2.2 注册路由
app.use(router);
app.mount("#app");

• 03 路由的出口: ./src/App.vue :

<template>
  <div class="app">
    <h2>App</h2>
    <!-- 3.1 按钮,点击跳转路由 -->
    <router-link to="/home">首页</router-link>
    <router-link to="/about">关于</router-link>
    <!-- 3.2 路由组件的出口 -->
    <router-view></router-view>
  </div>
</template>

<script>
export default {
  setup() {
    return {};
  },
};
</script>

• 图解:

路由重定向

• 我们这里还有一个不太好的实现:
  • 默认情况下, 进入网站的首页, 我们希望<router-view>渲染首页的内容；
  • 但是我们的实现中, 默认没有显示首页组件, 必须让用户点击才可以；
• 如何可以让路径默认跳到到首页, 并且<router-view>渲染首页组件呢?
• 我们在 routes 中又配置了一个映射：
  • path 配置的是根路径: /
  • redirect 是重定向, 也就是我们将根路径重定向到 /home 的路径下, 这样就可以得到我们想要的结果了.

history模式

• 另外一种选择的模式是 history 模式：
  • history 模式, url 不带有#号:

router-link标签

• router-link 事实上有很多属性可以配置：
• to 属性：
  • 是一个字符串，或者是一个对象. <router-link :to="{path:'/home'}" replace>首页</router-link> ,需要在 to 前面加冒号 :
• replace 属性：
  • 设置 replace 属性的话，当点击时，会调用 router.replace()，而不是 router.push()；点击浏览器的返回按钮,无法返回上一条页面记录
• active-class 属性：
  • 设置激活 a 元素后应用的 class，默认是 router-link-active
• exact-active-class 属性：
  • 链接精准激活时，应用于渲染的<a>的 class，默认是 router-link-exact-active；

<router-link :to="{path:'/home'}" replace>首页</router-link>

路由懒加载

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

// 路由的懒加载
const Home = () => import(/* webpackChunkName: 'home' */"../Views/Home.vue")  /* 在魔法注释指定分包后的文件名称 */
const About = () => import(/* webpackChunkName: 'about' */"../Views/About.vue") /* 在魔法注释指定分包后的文件名称 */

name和meta属性

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

动态路由的匹配

• 很多时候我们需要将给定匹配模式的路由映射到同一个组件：
  • 例如，我们可能有一个 User 组件，它应该对所有用户进行渲染，但是用户的 ID 是不同的；
  • 在 Vue Router 中，我们可以在路径中使用一个动态字段来实现，我们称之为 路径参数；

获取动态路由的值

• 那么在 User 中如何获取到对应的值呢？
  • 在 template 中，直接通过 $route.params获取值；
    • 在 created 中，通过 this.$route.params 获取值；
    • 在 setup 中，我们要使用 vue-router 库给我们提供的一个 hook useRoute；
      • 该 Hook 会返回一个 Route 对象，对象中保存着当前路由相关的值；

NotFound

• 对于哪些没有匹配到的路由，我们通常会匹配到固定的某个页面
  • 比如 NotFound 的错误页面中，这个时候我们可编写一个动态路由用于匹配所有的页面；

• 我们可以通过 $route.params.pathMatch 获取到传入的参数

• 如果在 /:pathMatch(.*)的后面再加一个星号*,则通过 $route.params.pathMatch 获取到的是一个由路径经过/分隔后的数组:(区别在于是否解析/)

路由的嵌套

• 什么是路由的嵌套呢？
  • 目前我们匹配的 Home、About、User 等都属于第一层路由，我们在它们之间可以来回进行切换；
• 但是呢，我们 Home 页面本身，也可能会在多个组件之间来回切换：
  • 比如 Home 中包括 Product、Message，它们可以在 Home 内部来回切换；
  • 这个时候我们就需要使用嵌套路由，在 Home 中也使用 router-view 来占位之后需要渲染的组件；

编程式导航

• 在 Option API 中 :

<template>
  <div class="app">
    <h2>App</h2>
    <!-- 3.1 按钮,点击跳转路由 -->
    <button @click="homeClick">首页</button>
    <button @click="aboutClick">关于</button>
    <!-- 3.2 路由的出口 -->
    <router-view></router-view>
  </div>
</template>

<script>
export default {
  methods: {
    homeClick() {
      // 编程式导航
      this.$router.push("/home");
    },
    aboutClick() {
      // 编程式导航,传递一个对象
      this.$router.push({
        path:"/about",
      });
    },
  },
};
</script>

• 在 Composition API 中:

<template>
  <div class="app">
    <h2>App</h2>
    <!-- 3.1 按钮,点击跳转路由 -->
    <button @click="homeClick">首页</button>
    <button @click="aboutClick">关于</button>
    <!-- 3.2 路由的出口 -->
    <router-view></router-view>
  </div>
</template>

<script setup>
import { useRouter } from "vue-router";
const router = useRouter();
const homeClick = () => {
  router.push("/home");
};
// 传递一个对象并携带参数
const aboutClick = () => {
  router.push({
    path: "/about",
    query: {
      name: "why",
      age: 18,
    },
  });
};
</script>

<!-- 在 /about 对应的组件的模板中获取 query 参数 -->
<h2>query:{{ $route.query.name }}-{{ $route.query.age }}</h2>

页面的前进与后退

• router 的 go 方法：

• router 也有 back：
  • 通过调用 history.back() 回溯历史。相当于 router.go(-1)；
• router 也有 forward：
  • 通过调用 history.forward() 在历史中前进。相当于 router.go(1)；

动态添加路由

• 某些情况下我们可能需要动态的来添加路由：

  • 比如根据用户不同的权限，注册不同的路由；
  • 这个时候我们可以使用一个方法 addRoute；

• 如果我们是为 route 添加一个 children 路由，那么可以传入对应的 name：

./src/router/index.js :

// 1.动态管理路由
let isAdmin = true
if (isAdmin) {
  // 一级路由
  router.addRoute({
    path: "/admin",
    component: () => import("../Views/Admin.vue")
  })

  // 给home 路由添加二级子路由  参数一: 一级路由的 name 属性,该 name 属性要求唯一,不能重复
  router.addRoute("home", {
    path: "vip",
    component: () => import("../Views/HomeVip.vue")
  })
}

// 获取router中所有的映射路由对象
console.log(router.getRoutes())

动态路由的其他方法

• 删除路由有以下三种方式：
  • 方式一：添加一个 name 相同的路由；
  • 方式二：通过 removeRoute 方法，传入路由的名称；
  • 方式三：通过 addRoute 方法的返回值回调；

• 路由的其他方法补充：
  • router.hasRoute()：检查路由是否存在。
  • router.getRoutes()：获取一个包含所有路由记录的数组。

路由导航守卫

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

// 2.路由导航守卫
// 进行任何的路由跳转之前, 传入的beforeEach中的函数都会被回调
// 需求: 进入到订单(order)页面时, 判断用户是否登录(isLogin -> localStorage保存token)
// 情况一: 用户没有登录, 那么跳转到登录页面, 进行登录的操作
// 情况二: 用户已经登录, 那么直接进入到订单页面
router.beforeEach((to, from) => {
  // 1.进入到任何别的页面时, 都跳转到login页面
  // if (to.path !== "/login") {
  //   return "/login"
  // }

  // 2.进入到订单页面时, 判断用户是否登录
  const token = localStorage.getItem("token")
  if (to.path === "/order" && !token) {
    return "/login"
  }
})

其他导航守卫

• Vue还提供了很多的其他守卫函数，目的都是在某一个时刻给予我们回调，让我们可以更好的控制程序的流程或者功能：
  • https://next.router.vuejs.org/zh/guide/advanced/navigation-guards.html
• 我们一起来看一下完整的导航解析流程：
  • 导航被触发。
  • 在失活的组件里调用 beforeRouteLeave 守卫。
  • 调用全局的 beforeEach 守卫。
  • 在重用的组件里调用 beforeRouteUpdate 守卫(2.2+)。
  • 在路由配置里调用 beforeEnter。
  • 解析异步路由组件。
  • 在被激活的组件里调用 beforeRouteEnter。
  • 调用全局的 beforeResolve 守卫(2.5+)。
  • 导航被确认。
  • 调用全局的 afterEach 钩子。
  • 触发 DOM 更新。
  • 调用 beforeRouteEnter 守卫中传给 next 的回调函数，创建好的组件实例会作为回调函数的参数传入。