v-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, 但是页面不刷新:

URL的hash

HTML5的History

目前常见的路由都是采用的以上两种模式之一:

例如vue中的router, react中的router, 都是采用的这两种模式

模式一: URL的hash:

URL的hash也就是锚点(#), 本质上是改变window.location的href属性；

我们可以通过直接赋值location.hash来改变href, 但是页面不发生刷新；

<div class="app">
  <a href="#/home">home</a>
  <a href="#/about">about</a>
  <div class="router-view"></div>
</div>

// 1.获取router-view
const routerViewEl = document.querySelector(".router-view");

// 2.监听hash改变
window.addEventListener("hashchange", () => {
  switch (location.hash) {
    case "#/home":
      routerViewEl.innerHTML = "home";
    case "#/about":
      routerViewEl.innerHTML = "about";
    default:
      routerViewEl.innerHTML = "default";
  }
});

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

模式二: HTML5的History

history接口是HTML5新增的, 它有六种模式改变URL而不刷新页面：

replaceState：替换原来的路径；

pushState：使用新的路径；

popState：路径的回退；

go：向前或向后改变路径；

forward：向前改变路径；

back：向后改变路径；

v-router使用

🍔v-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>；

🍔v-router使用流程

路由基本使用的流程如下:

先在一个单独的js文件中配置映射关系, 以及要使用的模式 (hash/history):

// 1.导入createRouter函数/方法, 以及要使用的hash模式
import { createRouter, createWebHashHistory } from "vue-router";

// 3.导入要配置映射关系的组件
import Home from "../views/Home.vue"
import About from "../views/About.vue"

// 2.通过createRouter创建一个路由: 映射关系
const router = createRouter({
  // 指定要是使用的模式: hash/history, 这里指定的hash
  history: createWebHashHistory(),
  // 传入一个对象, 对象中通过routes维护映射关系
  routes: [
    { path: "/home", component: Home },
    { path: "/about", component: About }
  ]
})

// 4.将路由导出, 供外界使用
export default router

在main.js文件中, 导入路由并使用app.use函数注册路由:

import { createApp } from 'vue'
import App from './App.vue'

// 导入路由
import router from './router'

const app = createApp(App)

// 使用app的use方法注册路由
app.use(router)

app.mount('#app')

通过<router-link>的to属性, 可以设置调转到哪一个url; 通过<router-view>设置组价要展示的位置；

<template>
  <div class="app">
    <h2>App</h2>
    <!-- 设置要跳转的url -->
    <!-- 点击首页, url会自动拼接上/#/home, Home组件 就会替换下面的router-view -->
    <router-link to="/home">首页</router-link>
    <!-- 点击关于, url会自动拼接上/#/about, About组件 就会替换下面的router-view -->
    <router-link to="/about">关于</router-link>

    <!-- 设置组件要展示的位置 -->
    <router-view></router-view>
  </div>
</template>

🍔v-router细节补充

补充一: 配置默认路由

我们这里还有一个不太好的实现:

默认情况下, 进入网站的首页, 我们希望<router-view>渲染首页的内容；

但是刚刚我们的实现中, 默认没有显示首页组件, 必须让用户点击才可以；

如何可以让路径默认跳到到首页, 并且<router-view>渲染首页组件呢?

const router = createRouter({
  history: createWebHashHistory(),
  routes: [
    // 添加一个映射关系, 设置默认的展示页面
    { path: "/", redirect: "/home" },
    { path: "/home", component: Home },
    { path: "/about", component: About }
  ]
})

我们在routes中又配置了一个映射：

path配置的是根路径: /

redirect的中文意思是从定向

也就是我们将根路径重定向到/home的路径下, 这样就可以得到我们想要的结果了, 用户打开页面就会默认跳转到首页

补充二: history模式

我们前面使用的是hash模式, 由于hash模式会在url中拼接一个井号: #会让人一部分人感觉并不舒服, 有一种地址不真实的感觉, 这个时候也可以采用另外一种模式: history模式

// 使用history模式 
import { createRouter, createWebHistory } from "vue-router";

const router = createRouter({
  // 使用history模式
  history: createWebHistory(),
  routes: [
    { path: "/", redirect: "/home" },
    { path: "/home", component: Home },
    { path: "/about", component: About }
  ]
})

history模式中, url的地址不会拼接上井号

当然两种模式各有优缺点, 有人喜欢hash, 觉得url结构清晰, 有人喜欢history, 不喜欢看到井号

两种模式大家无须纠结, 根据自己喜好选择即可

补充三: router-link的属性

刚刚我们有简单使用router-link的属性

router-link事实上有很多属性可以配置

to属性：

用于指定点击当前的router-link跳转到哪一个路径

是一个字符串，或者是一个对象

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

replace属性：

replace不用设置属性值

设置 replace 属性的话，当点击时，会调用 router.replace()，而不是 router.push()；

replace相当于是一种模式, 当在replace模式下, 点击路由切换时, 是没有历史记录的

<router-link to="/home" replace>首页</router-link>
<router-link to="/about" replace>关于</router-link>

active-class属性：

当router-link被选中是会自动添加上一个class，默认是router-link-active

例如我们想要设置当前显式页面的router-link变为红色, 我们可以直接设置router-link-active这个class

.router-link-active {
  color: red;
}

如果不想使用它默认的名字, 我们也可以通过active-class属性, 自己定义一个class名字

<router-link to="/home" active-class="home">首页</router-link>
<router-link to="/about" active-class="home">关于</router-link>

.home {
  color: red;
}

exact-active-class属性(下面路由嵌套时会讲解)：

链接精准激活时，应用于渲染的 <a> 的 class，默认class是router-link-exact-active；

懒加载分包处理

当打包构建应用时，JavaScript 包会变得非常大，影响页面加载：

如果我们能把不同路由对应的组件分割成不同的代码块，然后当路由被访问的时候才加载对应组件，这样就会更加高效；

也可以提高首屏的渲染效率；

其实这里还是我们前面讲到过的webpack的分包知识，而Vue Router默认就支持动态来导入组件：

这是因为component可以传入一个组件，也可以接收一个函数，该函数需要放回一个Promise；

而import函数就是返回一个Promise；

// 使用import函数, 打包时会进行分包处理
routes: [
  { 
    path: "/", 
    redirect: "/home" 
  },
  { 
    path: "/home",
    component: () => import("../views/Home.vue")
  },
  { 
    path: "/about", 
    component: () => import("../views/About.vue")
  }
]

打包效果如下

但是我们发现, 打包之后虽然分包了, 但是我们无法分清楚哪一个打包的文件是Home, 哪一个打包的文件是About

其实webpack从3.x开始支持对分包进行命名（chunk name）

 routes: [
  // 添加一个映射关系, 设置默认的展示页面
  { 
    path: "/", 
    redirect: "/home" 
  },
  { 
    path: "/home",
    component: () => import(/* webpackChunkName: 'home' */"../views/Home.vue")
  },
  { 
    path: "/about", 
    component: () => import(/* webpackChunkName: 'about'*/"../views/About.vue")
  }
]

我们再来看一下打包效果

注意: 在开发中我们使用路由, 一般都是会使用它的懒加载的

路由的其他属性

前面我使用了路由中的path属性和component属性

其实路由中还有name属性和meta属性

name属性

记录路由独一无二的名称, 在页面跳转的时候也是可以指定name的(用的不多)；

routes: [
  // 添加一个映射关系, 设置默认的展示页面
  { 
    // name要是独一无二, 唯一的
    name: "home",
    path: "/", 
    redirect: "/home" 
	}
]

meta属性

meta属性放一些额外的, 自定义的数据

这个自定义数据是可以在其他地方拿到的 (后面用到时在和大家介绍)

{ 
  path: "/", 
  redirect: "/home",
  // 自定义的一些数据
  meta: {
    name: "chenyq",
    age: 18,
    height: 1.88
  }
}

动态路由的使用

🍟动态路由基本匹配

很多时候我们需要将给定匹配模式的路由映射到同一个组件：

例如，我们可能有一个 User 组件，它应该对所有用户进行渲染，我们url需要拼接上用户的ID，但是用户的ID是不同的，意味着我们路径是不能写死的；

在Vue Router中，我们可以在路径中使用一个动态字段来实现，我们称之为路径参数；

routes: [
  {
    // 拼接时上:id表示路径不是写死的, 会有用户传入的id
    path: "/user/:id",
    component: () => import("../views/User.vue")
  }
]

在router-link中进行如下跳转：

<router-link to="/user/123">用户:123</router-link>
<router-link to="/user/321">用户:321</router-link>

🍟获取动态路由的值

上面代码中, 我们虽然实现了/user拼接不同的id显式同一个页面

但是我们页面中展示的效果是相同的, 我们需要在User组件中根据不同的用户, 获取到不同的id进行展示

那么在User中如何获取到对应的值呢？

在template中，直接通过 $route.params获取值；

在created中，通过 this.$route.params获取值；

在setup中，我们要使用 vue-router库给我们提供的一个hook useRoute；

该Hook会返回一个Route对象，对象中保存着当前路由相关的值；

在template模板中，通过 $route.params获取值

<template>
  <div class="user">
    <h2>User{{ $route.params.id }}</h2>
  </div>
</template>

在Options API 的 created中，通过 this.$route.params获取值

<script>
  export default {
		// Options API created中获取
    created() {
      console.log(this.$route.params.id)
    },
  }
</script>

在setup中，我们要使用 vue-router库给我们提供的一个hook useRoute；

<script setup>
  // vue-router库中给我们提供了一个hook函数useRoute
  import { useRoute } from 'vue-router';

  // useRoute函数会返回一个Route对象
  const route = useRoute()
  // 通过返回的Route对象可以拿到id
  console.log(route.params.id)
</script>

🍟NotFound

对于哪些没有匹配到的路由，我们通常会匹配到固定的某个页面

比如NotFound的错误页面中，这个时候我们可编写一个动态路由用于匹配所有的页面；

在vue中, 我们可以通过/:pathMatch(.*)匹配所有的路径

routes: [
  { 
    path: "/", 
    redirect: "/home"
  },
  { 
    path: "/home",
    component: () => import("../views/Home.vue")
  },
  { 
    path: "/about", 
    component: () => import("../views/About.vue")
  },
  {
    path: "/user/:id",
    component: () => import("../views/User.vue")
  },
  {
    // *匹配所有路由的路径
    path: "/:pathMatch(.*)",
    component: () => import("../views/NotFound.vue")
  }
]

当我们匹配不到前面路径的时候, 就会匹配最后一个路径, 显式NotFoun组件

如果我们想要提示用户的什么路径不正确

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

<template>
  <div>
    <h2>Not Found: 您的路径 {{ $route.params.pathMatch }} 不正确,请检查路径是否正确</h2>
  </div>
</template>

🍟匹配规则加 *

刚刚我们通过/:pathMatch(.*)匹配所有的路径, 这里还有另一种写法:

注意：我在/:pathMatch(.*)后面又加了一个 *；

{
  // 匹配所有路由的路径
  path: "/:pathMatch(.*)*",
  component: () => import("../views/NotFound.vue")
}

它们的区别在于解析的时候，是否解析 /

当没有加 * 号时

{
  // 没有加 * 号
  path: "/:pathMatch(.*)",
  component: () => import("../views/NotFound.vue")
}

当加了 * 号时

{
  // 加了 * 号
  path: "/:pathMatch(.*)*",
  component: () => import("../views/NotFound.vue")
}

路由嵌套的使用

什么是路由的嵌套呢？

目前我们匹配的Home、About、User等都属于第一层路由，我们在它们之间可以来回进行切换；

但是呢，我们Home页面本身，也可能会在多个组件之间来回切换：

比如Home中包括Product、Message，它们可以在Home内部来回切换；

这个时候我们就需要使用嵌套路由，在Home中也使用 router-view 来占位之后需要渲染的组件；

使用嵌套路由, 首先我们需要配置嵌套路由

在我们要配置嵌套路由的映射关系中, 添加children属性

下面我用Home组件举例

{ 
  path: "/home",
  component: () => import("../views/Home.vue"),
  // children中配置home的二级路由
  children: [
    // 定义默认展示路由
    {
      path: "/home",
      redirect: "/home/product"
    },
    {
      // 配置HomeProduct组件路由, 二级路径直接写子路径即可
      path: "product", // 相当于: /home/product
      component: () => import("../views/HomeProduct.vue")
    },
    {
      // 配置HomeMessage组件路由
      path: "message",
      component: () => import("../views/HomeMessage.vue")
    }
  ]
}

在Home组件中定义router-view展示二级路由

<template>
  <div>
    <h2>Home</h2>
    <!-- router-link切换导航 -->
    <router-link to="/home/product">商品</router-link>
    <router-link to="/home/message">信息</router-link>

    <!-- 使用router-view站位 -->
    <router-view></router-view>
  </div>
</template>

前面我们有说过会在嵌套路由和大家讲解exact-active-class属性

exact-active-class属性的默认class是router-link-exact-active

我们知道active-class属性会匹配当前选中的<router-view>标签

而exact-active-class是精准匹配当前选中的标签, 这个精准匹配怎么理解呢, 我给大家画一幅图展示

当上面代码中我们选中首页下面商品的时候:

此时首页和商品都是当前被选中的<router-link>标签, 都会添加上active-class属性的默认classrouter-link-active

而商品这个<router-link>标签还会额外添加, exact-active-class属性的router-link-exact-active

代码的页面跳转

前面我们路由的页面跳转都是通过<router-link>标签完成的

但是有时候我们希望通过代码来完成页面的跳转，比如点击的是一个按钮, 点击一个span等等其他元素也实现页面跳转

如下, 我想通过点击span和button代替刚刚Home组件中的两个<router-link>标签, 那么我可以分别监听span元素和button元素的点击, 在代码中实现页面跳转的功能

<span @click="homeSpanClick">商品</span>
<button @click="btnClick">信息</button>

<!-- 使用router-view站位 -->
<router-view></router-view>

使用push的特点是压入一个新的页面，那么在用户点击返回时，上一个页面还可以回退，但是如果我们希望当前页面是没有历史记录的，那么可以使用replace：

<script setup>
  // 导入函数useRouter
  import { useRouter } from "vue-router"

  // 通过函数useRouter拿到路由
  const router = useRouter()

  function homeSpanClick() {
    // 跳转到商品页 push有历史记录
    router.push("/home/product")
  }

  function btnClick() {
    // 跳转到信息页 replace没有历史记录
    router.replace("/home/message")
  }
</script>

push中也可以传入一个对象, 对象的写法就可以通过query属性传递参数

function homeSpanClick() {
  router.push({
    path: "/home/product",
    // 通过query传递参数
      query: {
        name: "chenyq",
        age: 18
      }
  })
}

在界面中通过 $route.query 来获取参数

<h2>{{ $route.query.name }} - {{ $route.query.age }}</h2>

页面的前进后退

router的go方法

// 导入函数useRouter
import { useRouter } from "vue-router"

// 通过函数useRouter拿到路由对象
const router = useRouter()

function goClick() {
  // 向前移动一条记录
  router.go(1)

  // 返回一条记录
  // router.go(-1)

  /// 向前三条记录
  // router.go(3)

  // 如果没有name多条记录, 静默失败
  // router.go(100)
  // router.go(-100)
}

router也有back：

通过调用 history.back() 回溯历史。相当于 router.go(-1)；

// 导入函数useRouter
import { useRouter } from "vue-router"

// 通过函数useRouter拿到路由对象
const router = useRouter()


function btnClick() {
  router.back()
}

router也有forward：

通过调用 history.forward() 在历史中前进。相当于 router.go(1)；

// 导入函数useRouter
import { useRouter } from "vue-router"

// 通过函数useRouter拿到路由对象
const router = useRouter()


function btnClick() {
  router.forward()
}

动态添加路由

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

比如有一个后台管理系统, 我们需要根据用户不同的权限，注册不同的路由, 来显示符合用户权限的操作菜单；

这个时候我们可以使用一个方法 addRoute；

例如我们定义一个变量isAdmin用于判断用户是否是管理员 (真实开发这个用于判断的变量是来自网络请求的)

如果isAdmin为true, 那么说明是管理员, 就为管理员注册路由可以进入管理员界面

如果不是管理员, 那么就不会注册管理员界面的路由, 没有注册路由管理员界面就不会展示出来

// 定义一个变量用于判断是否是管理员
let admine = false

if (admine) {
  // 使用addRoute方法添加一级路由
  router.addRoute({
    path: "/admin",
    component: () => import("../views/Admin.vue")
  })
}

上面是动态添加了一个一级路由, 那么能不能动态添加二级路由呢? 答案是肯定的

// 定义一个变量用于判断是否是管理员
let admine = true

if (admine) {
  // 动态添加二级路由, 第一个参数, 父路由的name值
  router.addRoute("home", {
    path: "vip",
    component: () => import("../views/HomeVip.vue")
  })
}

动态管理路由的其他方法（了解）

删除路由有以下三种方式：

方式一：添加一个name相同的路由, 由于name是唯一的, 所以新添加的路由会把原来的路由覆盖掉；

方式二：通过removeRoute(name值)的方法，传入路由的名称；

方式三：通过addRoute方法的返回值回调；

// 方式一
router.addRoute({ name: "about", path: "/about", component: About })
// 由于name相同, 新添加的会覆盖掉之前的路由
router.addRoute({ name: "about", path: "/home", component: Home })

// 方式二
router.addRoute({ name: "about", path: "/about", component: About })
// 通过removeRoute方法删除
router.removeRoute("about")

// 方式三
const remove = router.addRoute({ path: "/about", component: About })
// 调用addRoute方法会有一个返回值, 调用返回值可以删除路由
remove()

路由的其他方法补充：

router.hasRoute(name值)：检查路由是否存在。

console.log(router.hasRoute("home")) // true

router.getRoutes()：获取一个包含所有路由记录的数组。

console.log(router.getRoutes())

路由导航守卫

🍚beforeEach守卫函数

在开发中我们使用最多的就是beforeEach守卫函数

vue-router 提供的导航守卫主要用来通过跳转或取消的方式守卫导航, 那么什么是导航守卫呢?

在home页面跳转到about页面的这个过程, 我们称之为导航

在跳转这个过程的中间环节, 我们称之为导航守卫, 我们可以在这个环节对跳转进行拦截, 进行逻辑判断

全局的前置守卫beforeEach是在导航触发时会被回调的：

beforeEach传入一个函数, 传入的函数都会被回调, 且传入的函数有两个参数：

to：即将进入的路由Route对象；

from：即将离开的路由Route对象；

beforeEach有返回值：

返回false：取消当前导航；

不返回或者undefined：进行默认导航；

明确返回一个路由地址, 页面会跳转到返回的地址上去：

可以是一个string类型的路径；

可以是一个对象，对象中包含path、query、params等信息；

可选的第三个参数：next（不推荐使用）

在Vue2中我们是通过next函数来决定如何进行跳转的；

但是在Vue3中我们是通过返回值来控制的，不再推荐使用next函数，这是因为开发中很容易调用多次next；

比如我们完成如下一个功能：

现在我们有一个订单页面: 在订单页面我们主要实现两个逻辑:

判断用户是否登录

根据逻辑进行不同的处理

用户已经登录, 进入订单页面

用户没有登录, 进入登录页面, 等到用户登录成功, 进入首页(或者订单页)

路由配置中的逻辑:

// 路由导航守卫
router.beforeEach((to, from) => {
  const token = localStorage.getItem("token")
  // 判断用户是否登录, 是否去order页面
  if (!token && to.path === "/order") {
    return "/login"
  }
})

order中的登录逻辑

import { useRouter } from "vue-router"

const router = useRouter()

function loginClick() {
  // 模拟向服务器发生请求, 服务器会返回token
  localStorage.setItem("token", "chenyq")
  // 登录成功跳转会order页面
  router.push("/order")
}