一、前端路由的概念与原理
1.1、什么是路由
路由(英文:router)就是对应关系
。
1.2、SPA与前端路由
SPA 指的是一个web网站只有唯一的一个HTML页面,所有组件的展示与切换
都在这唯一的一个页面内完成。此时,不同组件之间的切换
需要通过前端路由
来实现。
结论:在SPA项目中,不同功能之间的切换
,需依赖于前端路由
来完成!
描点复习:
01.锚链接.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Document</title>
<style>
.box {
height: 640px;
}
#b1 {
background-color: pink;
}
#b2 {
background-color: red;
}
#b3 {
background-color: orange;
}
#b4 {
background-color: skyblue;
}
.side-bar {
position: fixed;
top: 0;
right: 0;
background-color: white;
}
</style>
</head>
<body>
<div class="side-bar">
<a href="#b1">b1</a>
<a href="#b2">b2</a>
<a href="#b3">b3</a>
<a href="#b4">b4</a>
</div>
<div class="box" id="b1"></div>
<div class="box" id="b2"></div>
<div class="box" id="b3"></div>
<div class="box" id="b4"></div>
</body>
</html>
1.3、什么是前端路由
通俗易懂的概念:Hash地址
与组件
之间的对应关系
。
1.4、前端路由的工作方式
- 用户
点击了
页面上的路由链接
- 导致了
URL地址栏
中的Hash值
发生了变化 前端路由监听了到Hash地址的变化
- 前端路由把当前
Hash地址对应的组件
渲染到浏览器中
结论:前端路由,指的是Hash地址
与组件之间
的对应关系
!
1.5、实现简易的前端路由
- 步骤1:通过
<component>
标签,结合commName
动态渲染组件。示例代码如下:
<!-- 通过 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:在
create
生命周期函数中,监听浏览器地址栏中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
}
}
}
案例如下:
App.vue
<template>
<div class="app-container">
<h1>App 根组件</h1>
<a href="#/home">首页</a>
<a href="#/movie">电影</a>
<a href="#/about">关于</a>
<hr />
<component :is="comName"></component>
</div>
</template>
<script>
// 导入组件
import Home from '@/components/Home.vue'
import Movie from '@/components/Movie.vue'
import About from '@/components/About.vue'
export default {
name: 'App',
data() {
// 在动态组件的位置,要展示的组件的名字,值必须是字符串
return {
comName: 'Home'
}
},
created() {
// 只要当前的App组件一被创建,就立即监听 window 对象的 onhashchange 事件
window.onhashchange = () => {
console.log('监听到了 hash 地址的变化', location.hash)
switch(location.hash) {
case '#/home':
this.comName = 'Home'
break
case '#/movie':
this.comName = 'Movie'
break
case '#/about':
this.comName = 'About'
break
}
}
},
// 注册组件
components: {
Home,
Movie,
About
}
}
</script>
<style lang="less" scoped>
.app-container {
background-color: #efefef;
overflow: hidden;
margin: 10px;
padding: 15px;
> a {
margin-right: 10px;
}
}
</style>
二、vue-router 的基本用法
2.1、什么是 vue-router
vue-router
是 vue.js 官方给出的路由解决方案
。它只能结合 vue 项目进行使用,能够轻松的管理 SPA 项目中组件的切换。
vue-router 的官方文档地址:https://router.vuejs.org/zh/
2.2、vue-router 安装和配置的步骤
- 安装 vue-router 包
创建路由模块
- 导入并挂载路由模块
- 声明
路由链接
和占位符
2.2.1、在项目中安装 vue-router
在 vue2 的项目中,安装 vue-router 的命令如下:
npm i vue-router@3.5.2 -S
2.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)
// 3. 创建路由的实例对象
const router = new VueRouter()
// 4. 向外共享路由的实例对象
export default router
2.2.3、导入并挂载路由模块
在 src/main.js
入口文件中,导入并挂载路由模块。示例代码如下:
import Vue from 'vue'
import App from './App.vue'
// 1. 导入路由模块
import router from '@/router'
// 导入 bootstrap 样式
import 'bootstrap/dist/css/bootstrap.min.css'
// 全局样式
import '@/assets/global.css'
Vue.config.productionTip = false
new Vue({
render: h => h(App),
// 2. 挂载路由模块
router: router
}).$mount('#app')
2.2.4、声明路由链接
和占位符
在 src/App.vue 组件中,使用 vue-router 提供的 <router-link>
和<router-view>
声明路由链接和占位符:
<template>
<div class="app-container">
<h1>App 根组件</h1>
<!-- 1. 定义路由链接 -->
<router-link to="/home">首页</router-link>
<router-link to="/movie">电影</router-link>
<router-link to="/about">关于</router-link>
<hr />
<!-- 2. 定义路由的占位符 -->
<component :is="comName"></component>
</div>
</template>
2.3、声明路由的匹配规则
在 /src/router/index.js 路由模块中,通过 routes数组
声明路由的匹配规则。示例代码如下:
// 1. 导入 Vue 和 VueRouter 的包
import Vue from 'vue'
import VueRouter from 'vue-router'
// 导入需要使用路由切换展示的组件
import Home from '@/components/Home.vue'
import Movie from '@/components/Movie.vue'
import About from '@/components/About.vue'
// 2. 调用 Vue.use() 函数,把 VueRouter 安装为 Vue 的插件
Vue.use(VueRouter)
// 3. 创建路由的实例对象
const router = new VueRouter({
routes: [ // 在 routes 数组中,声明路由的匹配规则
// path 表示要匹配的 hash 地址,component 表示要展示的路由组件
{ path: '/home', component: Home},
{ path: '/movie', component: Movie},
{ path: '/about', component: About}
]
})
// 4. 向外共享路由的实例对象
export default router
示例代码如下:
三、vue-router 的常见用法
3.1、路由重定向
路由重定向
指的是:用户在访问地址A
的时候,强制用户跳转
到地址C,从而展示特定的组件页面。通过路由规则的 redirect
属性,指定一个新的路由地址,可以很方便地设置路由的重定向:
// 创建路由的实例对象
const router = new VueRouter({
// 在 routes 数组中,声明路由的匹配规则
routes: [
// 当用户访问 / 的时候,通过 redirect 属性跳转到 /home 对应的路由规则
{ path: '/', redirect: '/home'},
{ path: '/home', component: Home},
{ path: '/movie', component: Movie},
{ path: '/about', component: About}
]
})
3.2、嵌套路由
通过路由实现组件的嵌套展示
,叫做嵌套路由。
3.3、声明子路由链接
和子路由占位符
在About.vue
组件中,声明 tab1 和 tab2 的子路由链接
以及子路由占位符
。示例代码如下:
<template>
<div class="about-container">
<h3>About 组件</h3>
<!-- 1. 在关于页面中,声明两个子路由链接 -->
<router-link to="/about/tab1">tab1</router-link>
<router-link to="/about/tab2">tab2</router-link>
<hr />
<!-- 2. 在关于页面中,声明子路由的占位符 -->
<router-view></router-view>
</div>
</template>
3.4、通过 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: [
{
// about 页面的路由规则(父级路由规则)
path: '/about',
component: About,
children: [ // 1. 通过 children 属性,嵌套声明子级路由规则
{ path: 'tab1', component: Tab1}, // 2. 访问 /about/tab1 时,展示 Tab1 组件
{ path: 'tab2', component: Tab2}, // 2. 访问 /about/tab2 时,展示 Tab2 组件
]
}
]
})
3.5、动态路由规则
思考:有如下3个路由链接:
<router-link to="/movie/1">电影1</router-link>
<router-link to="/movie/2">电影2</router-link>
<router-link to="/movie/3">电影3</router-link>
定义如下3个路由规则,是否可行???
{ path: '/movie/1', component: Movie},
{ path: '/movie/2', component: Movie},
{ path: '/movie/3', component: Movie},
缺点:路由规则的复用性差
3.5.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},
3.5.2、$route.params
参数对象
在动态路由
渲染出来的组件中,可以使用 this.$route.params
对象访问到动态匹配的参数值
。
<template>
<div class="movie-container">
<!-- this.$route 是路由的 "参数对象" -->
<h3>Movie 组件 -- {{ this.$route.params.id }}</h3>
</div>
</template>
<script>
export default {
name: 'Movie'
}
</script>
3.5.3、使用 props 接收路由参数
为了简化路由参数的获取形式
,vue-router允许在路由规则
中开启props传参
。示例代码如下:
// 1. 在定义路由规则时,声明 props: true 选项,
// 即可在 Movie 组件中,以 props 的形式接收到路由规则匹配到的参数项
<template>
<!-- 3. 直接使用 props 中接收的路由参数 -->
<h3>MyMovie 组件 --- {{ id }}</h3>
</template>
<script>
export default {
props: ['id'] // 2. 使用 props 接收路由规则中匹配到的参数项
}
</script>
3.6、声明书导航 & 编程式导航
在浏览器中,点击链接
实现导航的方式,叫做声明书导航
。例如:
- 普通网页中点击
<a>链接
、vue项目中点击<router-link>
都属于声明式导航
在浏览器中、调用API方法
实现导航的方式,叫做编程式导航
。例如:
- 普通页面中调用
location.href
跳转到新页面的方式,属于编程式导航
3.6.1、vue-router 中的编程式导航 API
vue-router 提供了许多编程式导航的API,其中最常用的导航 API 分别是:
- this.$router.
push
(‘hash地址’)
跳转到指定hash地址,并增加
一条历史记录 - this.$router.
replace
(‘hash地址’)
跳转到指定hash地址,并替换掉当前的
历史记录 - this.$router.
go
(数值n)
实现导航历史前进、后退
3.6.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 {
name: 'Home',
methods: {
gotoMovie() {
this.$router.push('/movie/1')
}
}
}
</script>
3.6.3、$router.replace
调用 this.$router.replace
()方法,可以跳转到指定的 hash 地址,从而展示对应的组件页面。
push 和 replace 的区别:
- push 会
增加一条历史记录
- replace 不会增加历史记录,而是
替换掉当前的历史记录
3.6.4、$router.go
调用 this.$router.go
()方法,可以在浏览历史中前进和后退。示例代码如下:
<template>
<div class="home-container">
<h3>MyMovie组件 --- {{ id }}</h3>
<button @click="goBack">后退</button>
</div>
</template>
<script>
export default {
name: 'Movie',
props: ['id'],
methods: {
goBack() {
// 后退到之前的组件页面
this.$router.go(-1)
}
}
}
</script>
3.6.5、$router.go
的简化用法
在实际开发中,一般只会前进和后退一层页面。因此 vue-router 提供了如下两个便捷方法:
- $router.
back
()
在历史记录中,后退
到上一个页面 - $router.
forward
()
在历史记录中,前进
到下一个页面
3.7、导航守卫
导航守卫
可以控制路由的访问权限
。示意图如下:
3.7.1、全局前置守卫
每次发生路由的导航跳转
时,都会触发全局前置守卫
。因此,在全局前置守卫中,程序员可以对每个路由进行访问权限
的控制:
// 创建路由的实例对象
const router = new VueRouter({ ... })
// 调用路由实例对象的 beforeEach 方法,即可声明“全局前置守卫”
// 每次发生路由导航跳转的时候,都会自动触发 fn 这个 “回调函数”
router.beforeEach(fn)
3.7.2、守卫方法的3个形参
全局前置守卫
的回调函数中接收3个形参,格式如下:
// 创建路由的实例对象
const router = new VueRouter({ ... })
// 全局前置守卫
router.beforeEach((to, from, next) => {
// to 是将要访问的路由的信息对象
// from 是将要离开的路由的信息对象
// next 是一个函数,调用 next() 表示放行,允许这次路由导航
})
3.7.3、next 函数的 3 种调用方式
参考示意图,分析next函数的3种调用方式最终导致的结果:
- 当前用户
拥有
后台主页的访问权限,直接放行:next() - 当前用户
没有
后台主页的访问权限,强制其跳转到登录页面
:next(‘/login
’) - 当前用户
没有
后台主页的访问权限,不允许跳转到后台主页
:next(false
)
3.7.4、控制后台主页的访问权限
router.beforeEach((to, from, next) => {
if (to.path === '/main') {
const token = localStorage.getItem('token')
if (token) {
next() // 访问的是后台主页,且有 token 的值
} else {
next('/login') // 访问的是后台主页,但是没有 token 的值
}
} else {
next() // 访问的不是后台主页,直接放行
}
})