Vue-Router详解

4、路由懒加载分包处理

4.1、路由懒加载

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

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

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

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

4.2、打包效果分析

• 我们看一下打包后的效果：
• 我们会发现分包是没有一个很明确的名称的，其实webpack从3.x开始支持对分包进行命名（chunk name）：

5、动态路由和路由嵌套

5.1、路由的其他属性

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

5.2、动态路由基本匹配

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

• 例如，我们可能有一个 User 组件，它应该对所有用户进行渲染，但是用户的ID是不同的；
• 在Vue Router中，我们可以在路径中使用一个动态字段来实现，我们称之为 路径参数；

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

5.3、获取动态路由的值

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

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

5.4、NotFound

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

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

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

5.5、匹配规则加*

这里还有另外一种写法：

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

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

5.6、路由的嵌套

什么是路由的嵌套呢？

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

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

• 比如Home中包括Product、Message，它们可以在Home内部来回切换；
• 这个时候我们就需要使用嵌套路由，在Home中也使用 router-view 来占位之后需要渲染的组件；

路由的嵌套配置：在一层路由中添加 children属性

6、路由的编程式导航

6.1、代码的页面跳转

有时候我们希望通过代码来完成页面的跳转，比如点击的是一个按钮：

当然，我们也可以传入一个对象：

如果是在setup中编写的代码，那么我们可以通过 useRouter 来获取：

6.2、query方式的参数

我们也可以通过query的方式来传递参数：

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

6.3、替换当前的位置

    使用push的特点是压入一个新的页面，那么在用户点击返回时，上一个页面还可以回退，但是如果我们希望当前页面是一个替换操作，那么可以使用replace：

6.4、页面的前进后退

router的go方法：

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

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

7、动态管理路由对象

7.1、动态添加路由

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

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

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

7.2、动态管理路由的其他方法

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

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

路由的其他方法补充：

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

8、路由导航守卫钩子

8.1、路由导航守卫

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

8.2、登录守卫功能

比如我们完成一个功能，只有登录后才能看到其他页面：

8.3、其他导航守卫

    Vue-Router还提供了很多的其他守卫函数，目的都是在某一个时刻给予我们回调，让我们可以更好的控制程序的流程或者功能：导航守卫 | Vue Router 

我们一起来看一下完整的导航解析流程：

1. 导航被触发。
2. 在失活的组件里调用 beforeRouteLeave 守卫。
3. 调用全局的 beforeEach 守卫。
4. 在重用的组件里调用 beforeRouteUpdate 守卫(2.2+)。
5. 在路由配置里调用 beforeEnter。
6. 解析异步路由组件。
7. 在被激活的组件里调用 beforeRouteEnter。
8. 调用全局的 beforeResolve 守卫(2.5+)。
9. 导航被确认。
10. 调用全局的 afterEach 钩子。
11. 触发 DOM 更新。
12. 调用 beforeRouteEnter 守卫中传给 next 的回调函数，创建好的组件实例会作为回调函数的参数传入。

9、示例代码

9.1、代码结构

9.2、index.js

import {createRouter, createWebHashHistory, createWebHistory} from 'vue-router'

// import Home from '../Views/Home.vue'
// import About from '../Views/About.vue'

// 路由的懒加载
// const Home = () => import(/* webpackChunkName: 'home' */"../Views/Home.vue")
// const About = () => import(/* webpackChunkName: 'about' */"../Views/About.vue")

// 创建一个路由: 映射关系
const router = createRouter({
    // 指定采用的模式: hash
    history: createWebHashHistory(),
    // history: createWebHistory(),
    // 映射关系
    routes: [
        {
            path: "/",
            redirect: "/home" // 跳转页面
        },
        {
            name: "home",
            path: "/home",
            component: () => import("../Views/Home.vue"),
            meta: {
                name: "why",
                age: 18
            },
            children: [
                {
                    path: "/home",
                    redirect: "/home/recommend"
                },
                {
                    path: "recommend", // /home/recommend
                    component: () => import("../Views/HomeRecommend.vue")
                },
                {
                    path: "ranking", // /home/ranking
                    component: () => import("../Views/HomeRanking.vue")
                }
            ]
        },
        {
            name: "about",
            path: "/about",
            component: () => import("../Views/About.vue")
        },
        {
            path: "/user/:id",
            component: () => import("../Views/User.vue")
        },
        {
            path: "/order",
            component: () => import("../Views/Order.vue")
        },
        {
            path: "/login",
            component: () => import("../Views/Login.vue")
        },
        {

            // 上面路径匹配不成功后，使用这个匹配任意路径
            // path: "/:pathMatch(.*)", // 后面不加上 * 对路径不进行解析
            path: "/:pathMatch(.*)*",
            component: () => import("../Views/NotFound.vue")
        }
    ]
})

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

    // 添加vip页面
    router.addRoute("home", {
        path: "vip",
        component: () => import("../Views/HomeVip.vue")
    })
}

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

// 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"
    }
})

export default router

9.3、 About.vue

<template>
  <div class="about">
    <h2>About: {{ $route.query }}</h2>
    <button @click="backBtnClick">返回</button>
  </div>
</template>

<script setup>
  import { useRouter } from 'vue-router'

  const router = useRouter()

  function backBtnClick() {
    // router.back()
    // router.forward()

    // go(delta)
    // go(1) -> forward()
    // go(-1) -> back()
    router.go(-1)
  }

</script>

<style scoped>
</style>

9.4、Admin.vue

<template>
  <div>
    <h2>Admin</h2>
    <p>哈哈哈哈哈哈哈</p>
    <p>哈哈哈哈哈哈哈</p>
    <p>哈哈哈哈哈哈哈</p>
    <p>哈哈哈哈哈哈哈</p>
    <p>哈哈哈哈哈哈哈</p>
    <p>哈哈哈哈哈哈哈</p>
  </div>
</template>

<script setup>

</script>

<style scoped>
</style>

9.5、Home.vue

<template>
  <div class="home">
    <h2>Home</h2>

    <div class="home-nav">
      <router-link to="/home/recommend">推荐</router-link>
      <router-link to="/home/ranking">排行</router-link>
    </div>

    <button @click="logoutClick">退出登录</button>

    <!-- 占位组件 -->
    <router-view></router-view>
  </div>
</template>

<script setup>

  function logoutClick() {
    localStorage.removeItem("token")
  }

</script>

<style scoped>
</style>

9.6、HomeRanking.vue

<template>
  <div class="home-ranking">
    <h2>各种榜单</h2>
    <ul>
      <li>热歌榜</li>
      <li>新歌榜</li>
      <li>原创榜</li>
      <li>歌手榜单</li>
    </ul>
  </div>
</template>

<script>
  export default {

  }
</script>

<style scoped>
</style>

9.7、HomeRecommend.vue

<template>
  <div class="home-recommend">
    <h2>HomeRecommend</h2>
    <ul>
      <li>推荐歌单1</li>
      <li>推荐歌单2</li>
      <li>推荐歌单3</li>
      <li>推荐歌单4</li>
    </ul>
  </div>
</template>

<script>
  export default {

  }
</script>

<style scoped>
</style>

9.8、HomeVip.vue

<template>
  <div>
    <h2>HomeVip</h2>
    <h2></h2>
  </div>
</template>

<script>
  export default {

  }
</script>

<style scoped>
</style>

9.9、Login.vue

<template>
  <div class="login">
    <h2>登录页面</h2>
    <button @click="loginClick">登录</button>
  </div>
</template>

<script setup>

  import { useRouter } from 'vue-router'

  const router = useRouter()

  function loginClick() {
    // 向服务器发送请求, 服务器会返回token
    localStorage.setItem("token", "coderwhy")

    // 跳转到order页面
    router.push("/order")
  }

</script>

<style scoped>
</style>

9.10、NotFound.vue

<template>
  <div class="not-found">
    <h2>NotFound: 您当前的路径{{ $route.params.pathMatch }}不正确, 请输入正确的路径!</h2>
  </div>
</template>

<script setup>
</script>

<style scoped>

  .not-found {
    color: red;
  }

</style>

9.11、Order.vue

<template>
  <div class="order">
    <h2>订单页面</h2>
    <ul>
      <li>订单1</li>
      <li>订单2</li>
      <li>订单3</li>
      <li>订单4</li>
      <li>订单5</li>
    </ul>
  </div>
</template>

<script>
  export default {

  }
</script>

<style scoped>
</style>

9.12、User.vue

<template>
  <div class="user">
    <!-- 在模板中获取到id -->
    <h2>User: {{ $route.params.id }}</h2>
    
  </div>

  
</template>

<script setup>
  import { useRoute, onBeforeRouteUpdate } from 'vue-router'

  const route = useRoute()
  console.log(route.params.id)

  // 获取route跳转id
  onBeforeRouteUpdate((to, from) => {
    console.log("from:", from.params.id)
    console.log("to:", to.params.id)
  })

</script>

<style scoped>
</style>

9.13、App.vue

<template>
  <div class="app">
    <h2>App Content</h2>
    <div class="nav">
      <router-link to="/home" replace>首页</router-link>
      <!-- <router-link :to="{ path: '/home' }" replace>首页</router-link> -->
      <router-link to="/about" replace active-class="active">关于</router-link>

      <router-link to="/user/123">用户123</router-link>
      <router-link to="/user/321">用户321</router-link>
      <router-link to="/order">订单</router-link>

      <!-- 其他元素跳转 -->
      <span @click="homeSpanClick">首页</span>
      <button @click="aboutBtnClick">关于</button>
    </div>

    <!--组件占位（确定渲染位置）-->
    <router-view></router-view>
  </div>
</template>

<script setup>
  import { useRouter } from 'vue-router'

  const router = useRouter()

  // 监听元素的点击
  function homeSpanClick() {
    // 跳转到首页
    // router.push("/home")
    router.push({
      // name: "home"
      path: "/home"
    })
  }
  function aboutBtnClick() {
    // 跳转到关于
    router.push({
      path: "/about",
      query: {
        name: "why",
        age: 18
      }
    })
  }

</script>

<style>

  .router-link-active {
    color: red;
    font-size: 20px;
  }

  .active {
    color: red;
    font-size: 20px;
  }

</style>

9.14、main.js

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

// localStorage.setItem("token", "coderwhy")

const app = createApp(App)
app.use(router)
app.mount('#app')