vue(七)路由

 一、前端路由的概念与原理

1.什么是前端路由

前端路由就是：Hash 地址与组件之间的对应关系。

2.SPA 与前端路由

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

3.前端路由的工作方式

① 用户点击了页面上的路由链接

② 导致了 URL 地址栏中的 Hash 值发生了变化

③ 前端路由监听了到 Hash 地址的变化

④ 前端路由把当前 Hash 地址对应的组件渲染都浏览器中

 4.实现简易的前端路由

步骤1：通过 <component> 标签，结合 comName 动态渲染组件。示例代码如下：

<!-- 通过is属性，指定要展示的组件名称 -->
<component :is="comName"></component>

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

步骤2：在 App.vue 组件中，为 <a> 链接添加对应的 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 使用

①创建路由模块

②导入并挂载路由模块

③声明路由链接和占位符

2.1 创建路由模块

在 src 源代码目录下，新建 router/index.js 路由模块（也可以在创建vue-cli时勾选router），并初始化如下的代码：

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

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

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

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

2.2 导入并挂载路由模块

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

import Vue from 'vue'
import App from './App.vue'
// 导入路由模块
import router from '@/router'

new Vue({
  render: h => h(App),
  //挂载路由
  router
}).$mount('#app')

2.3 声明路由链接和占位符

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

<template>
  <div class="app-container">
    <h1>App组件</h1>
  
    <!-- 定义路由链接 -->
    <router-link to="/home">首页</router-link>
    <router-link to="/movie">电影</router-link>
    <router-link to="/about">关于</router-link>

    <hr />

    <!-- 占位符 -->
    <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({
  // routes 是一个数组，作用：定义 “hash 地址” 与 “组件” 之间的对应关系
  routes: [
    { path: '/home', component: Home },
    { path: '/movie, component: Movie },
    { path: '/about, component: About},
  ]
})

三、vue-router 的常见用法

1. 路由重定向

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

// 导入需要的组件
import Home from '@/components/Home.vue'
import Movie from '@/components/Movie.vue'
import About from '@/components/About.vue'

// 创建路由的实例对象
const router = new VueRouter({
  // routes 是一个数组，作用：定义 “hash 地址” 与 “组件” 之间的对应关系
  routes: [
    // 当用户访问 / 时，通过redirect属性跳转到 /home 对应的路由规则
    { path: '/', redirect: '/home' },
    { path: '/home', component: Home },
    { path: '/movie, component: Movie },
    { path: '/about, component: About}
  ]
})

2. 嵌套路由

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

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

在 About.vue 组件中，声明 tab1 和 tab2 的子路由链接以及子路由占位符。

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

    <!-- 子级路由链接 -->
    <router-link to="/about">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: '/about',
      component: About,
      children: [     
        { path: 'tab1', component: Tab1 },
        { path: 'tab2', component: Tab2 }
      ]
    }
  ]
})

4.1 动态路由匹配

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

{ path: '/movie/:mid', component: Movie },

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

4.2 $route.params 参数对象

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

<template>
  <div class="movie-container">
    <!-- this.$route 是路由的“参数对象” -->
    <h3>Movie 组件 --- {{ $route.params.mid }} </h3>
  </div>
</template>

4.3 使用 props 接收路由参数

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

 //1. 在定义路由规则时，声明 props:true 选项，即可在Movie组件中
 //    以props的形式接收到路由规则匹配到的参数项
{ path: '/movie/:mid', component: Movie, props: true },、


<template>
    <h3>MyMovie 组件 --- {{ id }}</h3>
</template>

<script>
export default {
  // 接收 props 数据
  props: ['md'],
}
</script>

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

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

        普通网页中点击 <a> 链接、vue 项目中点击 <router-link> 都属于声明式导航。

在浏览器中，调用 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 地址，从而展示对应的组件页面。

<template>
  <div class="home-container">
    <h3>Home 组件</h3>
    <button @click="gotoMovie">跳转到Movie页面</button>
  </div>
</template>

<script>
export default {
  methods: {
    gotoMovie() {
      this.$router.push('/movie/1')
    }
  }
}
</script>

5.3 $router.replace

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

push 和 replace 的区别：

        push 会增加一条历史记录

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

6. 导航守卫

导航守卫可以控制路由的访问权限。

6.1 全局前置守卫 

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

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

router.beforeEach(function(to, from, next) {
  // to 表示将要访问的路由的信息对象
  // from 表示将要离开的路由的信息对象
  // next() 函数表示放行的意思
}

next 函数的 3 种调用方式:

当前用户拥有后台主页的访问权限，直接放行：next()

当前用户没有后台主页的访问权限，强制其跳转到登录页面：next('/login')

当前用户没有后台主页的访问权限，不允许跳转到后台主页：next(false)

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

router.beforeEach(function(to, from, next) {
  if (to.path === '/main') {
    // 要访问后台主页，需要判断是否有 token
    const token = localStorage.getItem('token')
    if (token) {
      next()
    } else {
      // 没有登录，强制跳转到登录页
      next('/login')
    }
  } else {
    next()// 不是访问后台，直接放行
  }
})