Vue 路由 (笔记)

前端路由的概念与原理

---

1. 什么是路由

路由（英文：router）就是对应关系

3. SPA 与前端路由

SPA 指的是一个 web 网站只有唯一的一个 HTML 页面，所有组件的展示与切换都在这唯一的一个页面内完成。
此时，不同组件之间的切换需要通过前端路由来实现。
结论：在 SPA 项目中，不同功能之间的切换，要依赖于前端路由来完成！

4. 什么是前端路由

通俗易懂的概念：Hash 地址与组件之间的对应关系。

5. 前端路由的工作方式

① 用户点击了页面上的路由链接
② 导致了 URL 地址栏中的 Hash 值发生了变化
③ 前端路由监听了到 Hash 地址的变化
④ 前端路由把当前 Hash 地址对应的组件渲染都浏览器中

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-ANVbAyyI-1633566246806)(./img/vue_pic9.png)]

结论：前端路由，指的是 Hash 地址与组件之间的对应关系！

6. 实现简易的前端路由

步骤 1：通过 标签，结合 comName 动态渲染组件

<component :is="comName"></component>

export default {
  name: 'App',
  data() {
    return {
      // 要展示的组件名
      comName: 'Home',
    }
  },
}

步骤 2：在 App.vue 组件中，为 链接添加对应的 hash 值

<a href="#/home">Home</a>
<a href="#/movie">Movie</a>
<a href="#/about">About</a>

步骤 3：在 created 生命周期函数中，监听浏览器地址栏中 hash 地址的变化，动态切换要展示的组件的名称

created() {
  window.onhashchange = () => {
    switch (location.hash) {
      case '#/home': // 点击了"首页"的链接
        this.comName = 'Home'
        break
      case '#/movie': // 点击了"电影"的链接
        this.comName = 'Movie'
        break
      case '#/about': // 点击了"关于"的链接
        this.comName = 'About'
        break
    }
  }
}

---

vue-router 的基本使用

---

1. 什么是 vue-router

vue-router 是 vue.js 官方给出的路由解决方案。它只能结合 vue 项目进行使用，能够轻松的管理 SPA 项目
中组件的切换

2. vue-router 安装和配置的步骤

① 安装 vue-router 包
② 创建路由模块
③ 导入并挂载路由模块
④ 声明路由链接和占位符

2.1 在项目中安装 vue-router

在 vue2 的项目中，安装 vue-router 的命令如下

npm i vue-router@3.5.2 -S

2.2 创建路由模块

在 src 源代码目录下，新建 router/index.js 路由模块，并初始化如下的代码：

// 1. 导入 Vue 和 VueRouter 的包
import Vue from 'vue'
import VueRouter from 'vue-router'

// 2. 调用 Vue.use() 函数，把 VueRouter 安装为 Vue 的插件
Vue.use(VueRouter) // Vue.use -- 用来安装插件

// 3. 创建路由的实例对象
const router = new VueRouter()

// 4. 向外共享路由的实例对象
export default router

2.3 导入并挂载路由模块

在 src/main.js 入口文件中，导入并挂载路由模块。示例代码如下：

// 1. 导入路由模块，目的是拿到路由的实例对象
// import router from '@/router/index.js'
// 在进行模块化导入的时候，若给定的是文件夹，则默认导入这个文件夹下名字叫做 index.js 的文件
import router from '@/router'

new Vue({
  render: (h) => h(App),
  // 2. 挂载路由模块
  // router：路由的实例对象
  // router: router
  router,
}).$mount('#app')

2.4 声明路由链接和占位符

在 src/App.vue 组件中，使用 vue-router 提供的 和 声明路由链接和占位符：

<template>
  <div class="app-container">
    <h1>App2 组件</h1>

    <!-- 1. 定义路由链接 -->
    <!-- 可以用 router-link 代替 a 链接。其中，to 替换 href ; 去掉 # -->
    <router-link to="/home">首页</router-link>
    <router-link to="/movie">电影</router-link>
    <router-link to="/about">关于</router-link>

    <hr />

    <!-- 2. 定义路由的占位符 -->
    <router-view></router-view>
  </div>
</template>

3. 声明路由的匹配规则

在 src/router/index.js 路由模块中，通过 routes 数组声明路由的匹配规则。示例代码如下：

import Home from '@/components/Home.vue'
import Movie from '@/components/Movie.vue'
import About from '@/components/About.vue'

// 创建路由的实例对象
const router = new VueRouter({
  // 数组，定义 hash 地址和组件的对应关系
  routes: [
    // 路由规则
    { path: '/home', component: Home },
    { path: '/movie', component: Movie },
    { path: '/about', component: About },
  ],
})

---

vue-router 的常见用法

---

1. 路由重定向

路由重定向指的是：用户在访问地址 A 的时候，强制用户跳转到地址 C ，从而展示特定的组件页面。
通过路由规则的 redirect 属性，指定一个新的路由地址，可以很方便地设置路由的重定向：

const router = new VueRouter({
  routes: [
    // 重定向路由规则
    { path: '/', redirect: '/home' },
    // 路由规则
    { path: '/home', component: Home },
    { path: '/movie', component: Movie },
    { path: '/about', component: About },
  ],
})

2. 嵌套路由

通过路由实现组件的嵌套展示，叫做嵌套路由。

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-METRrunN-1633566246809)(./img/vue_pic10.png)]

3.1 声明子路由链接和子路由占位符

在 About.vue 组件中，声明 tab1 和 tab2 的子路由链接以及子路由占位符。示例代码如下：

<template>
  <div class="about-container">
    <h3>About 组件</h3>

    <!-- 子级路由链接 -->
    <router-link to="/about/tab1">tab1</router-link>
    <router-link to="/about/tab2">tab2</router-link>

    <hr />
    <router-view></router-view>
  </div>
</template>

3.2 通过 children 属性声明子路由规则

在 src/router/index.js 路由模块中，导入需要的组件，并使用 children 属性声明子路由规则：

import Tab1 from '@/components/tabs/Tab1.vue'
import Tab2 from '@/components/tabs/Tab2.vue'

const router = new VueRouter({
  routes: [
    { path: '/', redirect: '/home' },
    { path: '/home', component: Home },
    { path: '/movie', component: Movie },
    {
      path: '/about',
      component: About,
      // redirect: '/about/tab1', // 子路由重定向
      children: [
        // 通过 children 属性，嵌套声明子级路由规则
        // 默认子路由：若 children 数组中，某个路由规则的 path 值为空字符串，则这条路由规则叫做：默认子路由
        { path: '', component: Tab1 }, // 访问 /about/tab1 时，展示 Tab1 组件
        { path: 'tab2', component: Tab2 }, // 访问 /about/tab2 时，展示 Tab2 组件
      ],
    },
  ],
})

🔔 子路由的 hash 不加 ‘/’
🔔 默认子路由和重定向都可以设置默认展示的组件

4. 动态路由匹配

4.1 动态路由的概念

动态路由指的是：把 Hash 地址中可变的部分定义为参数项，从而提高路由规则的复用性。 在 vue-router 中使用英文的冒号（:）来定义路由的参数项。示例代码如下：

// 路由中的动态参数以 : 进行声明，冒号后面是动态参数的名称
{ path: '/movie/:id', component: Movie }

// 将以下 3 个路由规则，合并成了一个，提高了路由规则的复用性
{ path: '/movie/1', component: Movie }
{ path: '/movie/2', component: Movie }
{ path: '/movie/3', component: Movie }

4.2 $route.params 参数对象

在动态路由渲染出来的组件中，可以使用 this.$route.params 对象访问到动态匹配的参数值。

<template>
  <div class="movie-container">
    <!-- this.$route 是路由的"参数对象" -->
    <!-- this.$router 是路由的"导航对象" -->
    <h3>Movie 组件 --- {{ this.$route.params.id }}</h3>
    <!-- this 可以省略 -->
  </div>
</template>

4.3 使用 props 接收路由参数

为了简化路由参数的获取形式，vue-router 允许在路由规则中开启 props 传参。示例代码如下：

{ path: '/movie/:mid', component: Movie, props: true },
// 为路由规则开启 props 传参，从而方便拿到动态参数的值

<!-- 直接使用 props 中接收的路由参数 -->
<h3>Movie 组件 --- {{ mid }}</h3>

export default {
  // 使用 props 接收路由规则中匹配到的参数项
  props: ['mid'],
}

🔔 注意 1：在 hash 地址中， / 后面的参数项叫做"路径参数"
在路由"参数对象"中，需要使用 this.$route.params来访问路径参数:bell:注意2：在hash地址中?后面的参数项，叫做"查询参数"在路由"参数对象"中，需要使用this.$route.query 来访问查询参数
🔔 注意 3：在 this.$route 中，path 只是路径部分；fullPath 是完整的地址

5. 声明式导航 & 编程式导航

① 在浏览器中，点击链接实现导航的方式，叫做声明式导航。例如：

• 普通网页中点击 链接、vue 项目中点击 都属于声明式导航

② 在浏览器中，调用 API 方法实现导航的方式，叫做编程式导航。例如：

• 普通网页中调用 location.href 跳转到新页面的方式，属于编程式导航

5.1 vue-router 中的编程式导航 API

vue-router 提供了许多编程式导航的 API，其中最常用的导航 API 分别是：
① this.$router.push(‘hash 地址’)

• 跳转到指定 hash 地址，并增加一条历史记录

② this.$router.replace(‘hash 地址’)

• 跳转到指定的 hash 地址，并替换掉当前的历史记录

③ this.$router.go(数值 n)

• 实现导航历史前进、后退

5.2 $router.push

调用 this.$router.push() 方法，可以跳转到指定的 hash 地址，从而展示对应的组件页面。示例代码如下：

gotoLk() {
  // 通过编程式导航 API 跳转到指定页面
  this.$router.push('/movie/1')
},

5.3 $router.replace

调用 this.$router.replace() 方法，可以跳转到指定的 hash 地址，从而展示对应的组件页面。
push 和 replace 的区别：

• push 会增加一条历史记录
• replace 不会增加历史记录，而是替换掉当前的历史记录

5.4 $router.go

调用 this.$router.go() 方法，可以在浏览历史中前进和后退。示例代码如下：

goback() {
  this.$router.go(-1)
}

• 若后退的层数超过上限则不变

5.5 $router.go 的简化用法

在实际开发中，一般只会前进和后退一层页面。因此 vue-router 提供了如下两个便捷方法：

① $router.back()

• 在历史记录中，后退到上一个页面

② $router.forward()

• 在历史记录中，前进到下一个页面

<!-- 在行内使用编程式导航时， this 必须要省略 -->
<button @click="$router.back()">后退退</button><br />
<button @click="$router.forward()">前进进</button>

6. 导航守卫

导航守卫可以控制路由的访问权限。示意图如下：
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-XURpipwL-1633566246812)(./img/vue_pic11.png)]

6.1 全局前置守卫

每次发生路由的导航跳转时，都会触发全局前置守卫。因此，在全局前置守卫中，程序员可以对每个路由进行访问权限的控制：

// 为 router 实例对象声明全局前置守卫
// 每次发生路由导航跳转的时候，都会自动触发 fn 这个回调函数
router.beforeEach(fn)

6.2 守卫方法的 3 个形参

全局前置守卫的回调函数中接收 3 个形参，格式为：

router.beforeEach(function (to, from, next) {
  // to 是将要访问的路由的信息对象
  // from 是将要离开的路由的信息对象
  // next 是一个函数，调用 next() 表示放行，允许这次路由导航
  next()
})

6.3 next 函数的 3 种调用方式

参考示意图，分析 next 函数的 3 种调用方式最终导致的结果：

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-bUB4Ctij-1633566246814)(./img/vue_pic12.png)]

当前用户拥有后台主页的访问权限，直接放行：next()
当前用户没有后台主页的访问权限，强制其跳转到登录页面：next('/login')
当前用户没有后台主页的访问权限，不允许跳转到后台主页：next(false)

6.4 控制后台主页的访问权限

router.beforeEach(function (to, from, next) {
  // 分析
  // 1. 拿到用户将要访问的 hash 地址
  // 2. 判断 hash 地址是否等于 /main
  //   2.1 若等于，则需要登录才能访问成功
  //   2.2 否则无需登录可以直接放行 next()
  // 3. 若访问地址是 /main 则需要读取 localStorage 的 token 值
  //   3.1 若有 token 则放行
  //   3.2 若没有 token 则强制跳转到 /login 登录页面

  if (to.path === '/main') {
    const token = localStorage.getItem('token')
    if (token) {
      next() // 访问的是后台主页，并且有 token 值
    } else {
      next('/login') // 访问的是后台主页，但是没有 token 值
    }
  } else {
    next() // 访问的不是后台主页，直接放行
  }
})

---

案例

---

1. 配置路由模块 /router/index.js
2. 在 main.js 中导入并挂载路由模块
3. 配置登录页面 Login 的路由规则，设置重定向
4. 在 App 放置占位符
5. 在 Login 模块模拟登录规则

• 用户名、密码
• 重置按钮
• 提交按钮–判断用户名密码是否正确，存储 token 至 localStorage

6. 配置后台主页的路由规则
7. 设置编排后台主页的页面结构
8. 设置退出登录按钮逻辑
9. 设置全局前置守卫
10. 嵌套路由

• 配置五个侧边栏的路由规则

11. 设置用户管理页面

• 循环渲染数据
• 设置详情链接，点击跳转至详情页
• 设置用户详情页路由规则及后退按钮
• 传递参数 id ，不同 id 指向不同页面 (动态路由匹配)

12. 设置路由重定向 – 默认打开 users

🔔 注意：url 使用小写