• 路由基础
  • URL的hash
  • HTML5的History
• 认识Vue-router
  • 常用函数和对象
  • 常用组件
• 路由配置文件
  • 1、路由的默认路径
  • 2、history模式
  • 3、路由懒加载
  • 4、路由的其他属性
  • 5、动态路由基本匹配
  • 6、NotFound页面未找到
  • 7、路由的嵌套
• 编程式导航
  • 代码的页面跳转
  • query方式的参数
  • router-link的v-slot
  • router-view的v-slot
  • 动态添加路由
  • 动态删除路由
• 路由导航守卫
  • 其他导航守卫
  • 导航进度条插件
  • 完整的导航解析流程：
• ide模板

路由基础

URL的hash

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

2、 URL的hash

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

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

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

window.addEventListener("hashchange", () => {
      switch(location.hash) {
        case "#/home":
          contentEl.innerHTML = "Home";
          break;
        case "#/about":
          contentEl.innerHTML = "About";
          break;
        default:
          contentEl.innerHTML = "Default";
      }
})

HTML5的History

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

• replaceState：替换原来的路径；

• pushState：使用新的路径；

• popState：路径的回退；

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

• forward：向前改变路径；

• back：向后改变路径；

认识Vue-router

目前前端流行的三大框架, 都有自己的路由实现:

• Angular的ngRouter

• React的ReactRouter

• Vue的vue-router

Vue Router 是 Vue.js 的官方路由。它与 Vue.js 核心深度集成，让用 Vue.js 构建单页应用变得非常容易。

• 目前Vue路由最新的版本是4.x版本，我们上课会基于最新的版本讲解。

• vue-router是基于路由和组件的

路由用于设定访问路径, 将路径和组件映射起来.

在vue-router的单页面应用中, 页面的路径的改变就是组件的切换.

安装Vue Router：

npm i vue-router@4  // 指定版本

常用函数和对象

• createWebHistory： history为html5的history模式

• createWebHashHistory ： history为hash模式

• createRouter （用于创建路由）

• useRoute

• RouteRecordRaw : 配置的就是一条条路由记录

• router

  • addRoute、removeRoute、hasRoute、getRoutes、push、replace、back、forward、go、beforeEach、

常用组件

A、router-link

router-link事实上有很多属性可以配置， vue2里面有tag属性，可以指定渲染啥元素（a, button）

1、to属性

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

2、replace属性

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

3、 active-class属性

设置激活a元素后应用的class，默认是router-link-active， 注意：如果访问的地址是/home/goods时， /home的链接也会加上这个属性

4、 exact-active-class属性

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

B、router-view

<router-view v-slot="props">
      <!-- <transition name="why"> -->
        <keep-alive>
          <component :is="props.Component"></component>
        </keep-alive>
      <!-- </transition> -->
</router-view>

路由配置文件

1、路由的默认路径

默认情况下, 进入网站的首页, 我们希望<router-view>渲染首页的内容；但是我们的实现中, 默认没有显示首页组件, 必须让用户点击才可以；

n 如何可以让路径默认跳到到首页, 并且

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

• path配置的是根路径: /

• redirect是重定向, 也就是我们将根路径重定向到/home的路径下, 这样就可以得到我们想要的结果了.

const routes = [
  {  path: "/",  redirect: "/home" },
  ...
]

2、history模式

// 创建一个路由对象router
const router = createRouter({
  routes,
  history: createWebHistory()
})

3、路由懒加载

当打包构建应用时，JavaScript 包会变得非常大，影响页面加载： 如果我们能把不同路由对应的组件分割成不同的代码块，然后当路由被访问的时候才加载对应组件，这样就会更加高效； 也可以提高首屏的渲染效率；

其实这里还是我们前面讲到过的webpack的分包知识，而Vue Router默认就支持动态来导入组件：这是因为component可以传入一个组件，也可以接收一个函数，该函数需要放回一个Promise； 而import()函数就是返回一个Promise；

• 可以通过/* webpackChunkName: "home-chunk" */ 指定webpack分包的文件名称

// import Home from "../pages/Home.vue";
// import About from "../pages/About.vue";

const home = import(/* webpackChunkName: "home-chunk" */"../pages/Home.vue")

{ 
    path: "/about",
    name: "about",
    component: () => import("../pages/About.vue") 
},

 { 
    path: "/home", 
    name: "home",
    component: home
},

4、路由的其他属性

• name属性：路由记录独一无二的名称；

• meta属性：自定义的数据

5、动态路由基本匹配

很多时候我们需要将给定匹配模式的路由映射到同一个组件：例如，我们可能有一个 User 组件，它应该对所有用户进行渲染，但是用户的ID是不同的；

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

获取动态路由的值

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

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

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

• 在setup中，我们要使用 vue-router库给我们提供的一个hook useRoute()； 该Hook会返回一个Route对象，对象中保存着当前路由相关的值；

6、NotFound页面未找到

• 对于哪些没有匹配到的路由，我们通常会匹配到固定的某个页面，比如NotFound的错误页面中，这个时候我们可编写一个动态路由用于匹配所有的页面；我们可以通过 $route.params.pathMatch获取到传入的参数，获取到的是字符串

• 这里还有另外一种写法： 注意：我在/:pathMatch(.*)*后面又加了一个 *； 它们的区别在于解析的时候，会把 /作为分隔符，这里$route.params.pathMatch返回的是数组

{
    path: "/:pathMatch(.*)*",
    component: () => import("../pages/NotFound.vue")
  }

7、路由的嵌套

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

编程式导航

代码的页面跳转

有时候我们希望通过代码来完成页面的跳转，比如点击的是一个按钮，如果是在setup中编写的代码，那么我们可以通过 useRouter()来获取

<script>
  import { useRoute } from "vue-router";

  export default {
    created() {
      console.log(this.$route.params.username);
    },
    setup() {
      const route = useRoute();
      console.log(route.params.username);
      
      route.replace('/home');  // push
    }
  }
</script>

query方式的参数

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

router-link的v-slot

在vue-router3.x的时候，router-link有一个tag属性，可以决定router-link到底渲染成什么元素：但是在vue-router4.x开始，该属性被移除了； 而给我们提供了更加具有灵活性的v-slot的方式来定制渲染的内容；

v-slot如何使用呢？

• 首先，我们需要使用custom表示我们整个元素要自定义

• 如果不写，那么自定义的内容会被包裹在一个 a 元素中；

其次，我们使用v-slot作用域插槽来来获取内部传给我们的值：

• href：解析后的 URL；
• route：解析后的规范化的route对象；
• navigate：触发导航的函数；
• isActive：是否匹配的状态；
• isExactActive：是否是精准匹配的状态；

<!-- props: href 跳转的链接 -->
    <!-- props: route对象 -->
    <!-- props: navigate导航函数 -->
    <!-- props: isActive 是否当前处于活跃的状态 -->
    <!-- props: isExactActive 是否当前处于精确的活跃状态 -->
<router-link to="/home" v-slot="props" custom>
      <button @click="props.navigate">{{props.href}}</button>
      <button @click="props.navigate">哈哈哈</button>
      <span :class="{'active': props.isActive}">{{props.isActive}}</span>
      <span :class="{'active': props.isActive}">{{props.isExactActive}}</span>
      <!-- <p>{{props.route}}</p> -->
</router-link>

router-view的v-slot

router-view也提供给我们一个插槽，可以用于 <transition> 和<keep-alive> 组件来包裹你的路由组件：

• Component：要渲染的组件；

• route：解析出的标准化路由对象

<router-view v-slot="props">
  <!-- <transition name="why"> -->
    <keep-alive>
      <component :is="props.Component"></component>
    </keep-alive>
  <!-- </transition> -->
</router-view>

.why-enter-from,
  .why-leave-to {
    opacity: 0;
  }

  .why-enter-active,
  .why-leave-active {
    transition: opacity 1s ease;
  }

动态添加路由

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

• 比如根据用户不同的权限，注册不同的路由；

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

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

// 动态添加路由
const categoryRoute = {
  path: "/category",
  component: () => import("../pages/Category.vue")
}

// 添加顶级路由对象
router.addRoute(categoryRoute);

// 添加二级路由对象
router.addRoute("home", {
  path: "moment",
  component: () => import("../pages/HomeMoment.vue")
})

动态删除路由

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

• 方式一：添加一个name相同的路由；

• 方式二：通过removeRoute方法，传入路由的名称；

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

路由的其他方法补充：

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

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

路由导航守卫

1、vue-router 提供的导航守卫主要用来通过跳转或取消的方式守卫导航。

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

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

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

2、它有返回值：

• false：取消当前导航；

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

3、返回一个路由地址：

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

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

4、可选的第三个参数：next

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

// 导航守卫beforeEach
let counter = 0;
// to: Route对象, 即将跳转到的Route对象
// from: Route对象, 
/**
 * 返回值问题:
 *    1.false: 不进行导航
 *    2.undefined或者不写返回值: 进行默认导航
 *    3.字符串: 路径, 跳转到对应的路径中
 *    4.对象: 类似于 router.push({path: "/login", query: ....})
 */
router.beforeEach((to, from) => {
  console.log(`进行了${++counter}路由跳转`)
  // if (to.path.indexOf("/home") !== -1) {
  //   return "/login"
  // }
  if (to.path !== "/login") {
    const token = window.localStorage.getItem("token");
    if (!token) {
      return "/login"
    }
  }
})

其他导航守卫

Vue还提供了很多的其他守卫函数，目的都是在某一个时刻给予我们回调，让我们可以更好的控制程序的流程或者功能： https://next.router.vuejs.org/zh/guide/advanced/navigation-guards.html

• 全局解析守卫 (opens new window)

• 全局后置钩子 (opens new window)

• 路由独享的守卫 (opens new window)

• 组件内的守卫 | Vue Router (vuejs.org) (opens new window)

导航进度条插件

安装

npm i nprogress
npm i --save-dev @types/nprogress  // ts环境中需要安装nprogress的类型声明

router.beforeEach( (to, from)=>{
  NProgress.start()

  if (to.path !== '/login') {
    const token = localCache.getCache('token')
    if (!token) {
      return '/login'
    }
  }
})

router.afterEach(() => {
  NProgress.done()
})

完整的导航解析流程：

• 导航被触发。

• 在失活的组件里调用 beforeRouteLeave 守卫。

• 调用全局的 beforeEach 守卫。

• 在重用的组件里调用 beforeRouteUpdate 守卫(2.2+)。

• 在路由配置里调用 beforeEnter。

• 解析异步路由组件。

• 在被激活的组件里调用 beforeRouteEnter。

• 调用全局的 beforeResolve 守卫(2.5+)。

• 导航被确认。

• 调用全局的 afterEach 钩子。

• 触发 DOM 更新。

• 调用 beforeRouteEnter 守卫中传给 next 的回调函数，创建好的组件实例会作为回调函数的参数传入。

ide模板

vrouter

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

const routes=[
    {
        path:'/',
        redirect:'/goods'
    },
    {
        name:'home',
        path:'/home',
        component: import(/* webpackChunkName: "home-chunk" */'../pages/goods/GoodsList')
    }
];

const router=createRouter({
    routes,
    history : createWebHistory()
});

export default router;

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

// import Home from "../pages/Home.vue";
// import About from "../pages/About.vue";

// 配置映射关系
const routes = [
  { 
    path: "/", 
    redirect: "/home" 
  },
  // /home/shops
  { 
    path: "/home", 
    name: "home",
    component: () => import(/* webpackChunkName: "home-chunk" */"../pages/Home.vue"),
    meta: {
      name: "why",
      age: 18,
      height: 1.88
    },
    children: [
      {
        path: "",
        redirect: "/home/message"
      },
      {
        path: "message",
        component: () => import("../pages/HomeMessage.vue")
      },
      {
        path: "shops",
        component: () => import("../pages/HomeShops.vue")
      }
    ]
  },
  { 
    path: "/about",
    name: "about",
    component: () => import("../pages/About.vue") 
  },
  { 
    path: "/user/:username/id/:id",
    component: () => import("../pages/User.vue") 
  },
  {
    path: "/login",
    component: () => import("../pages/Login.vue")
  },
  {
    path: "/:pathMatch(.*)",
    component: () => import("../pages/NotFound.vue")
  }
];

// 创建一个路由对象router
const router = createRouter({
  routes,
  history: createWebHistory()
})

// 动态添加路由
const categoryRoute = {
  path: "/category",
  component: () => import("../pages/Category.vue")
}

// 添加顶级路由对象
router.addRoute(categoryRoute);

// 添加二级路由对象
router.addRoute("home", {
  path: "moment",
  component: () => import("../pages/HomeMoment.vue")
})


// 导航守卫beforeEach
let counter = 0;
// to: Route对象, 即将跳转到的Route对象
// from: Route对象, 
/**
 * 返回值问题:
 *    1.false: 不进行导航
 *    2.undefined或者不写返回值: 进行默认导航
 *    3.字符串: 路径, 跳转到对应的路径中
 *    4.对象: 类似于 router.push({path: "/login", query: ....})
 */
router.beforeEach((to, from) => {
  console.log(`进行了${++counter}路由跳转`)
  // if (to.path.indexOf("/home") !== -1) {
  //   return "/login"
  // }
  if (to.path !== "/login") {
    const token = window.localStorage.getItem("token");
    if (!token) {
      return "/login"
    }
  }
})

export default router