文章目录
前端路由的概念与原理
1. 什么是路由
路由(英文:router)就是对应关系。
2. SPA 与前端路由
SPA 指的是一个 web 网站只有唯一的一个 HTML 页面,所有组件的展示与切换都在这唯一的一个页面内完成。
此时,不同组件之间的切换需要通过前端路由来实现。
结论:在 SPA 项目中,不同功能之间的切换,要依赖于前端路由来完成!
3. 什么是前端路由
通俗易懂的概念:Hash 地
址与组件
之间的对应关系
。
4. 前端路由的工作方式
① 用户点击了页面上的路由链接
② 导致了 URL 地址栏中的 Hash 值发生了变化
③ 前端路由监听了到 Hash 地址的变化
④ 前端路由把当前 Hash 地址对应的组件渲染都浏览器中
结论:前端路由,指的是 Hash 地址与组件之间的对应关系!
5. 实现简易的前端路由
步骤1:通过 标签,结合 comName 动态渲染组件。示例代码如下:
<!-- 通过 is 属性,指定要展示的组件的名称 -->
<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 地址的变化,动态切换要展示的组件的名称:
create() {
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 项目中组件的切换。其底层封装了浏览器window.onhashchange事件
vue-router 的官方文档地址:https://router.vuejs.org/zh/
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() 函数 : 安装插件的
Vue.use(VueRouter)
// 3. 创建路由的实例对象
const router = new VueRouter()
// 4. 向外共享路由的实例对象
export default router
2.3 导入并挂载路由模块
在 src/main.js 入口文件中,导入并挂载路由模块。示例代码如下:
import Vue from 'Vue'
import App from './App.vue'
// 1. 导入路由模块
// 在进行模块化导入的时候,如果给定的是文件夹,则默认导入这个文件夹下的index.js文件
import router from '@/router'
new Vue({
render: h => h(App),
// 2. 挂载路由模块
router: router
}).$mount('#app')
2.4 声明路由链接和占位符
在 src/App.vue 组件中,使用 vue-router 提供的 和 声明路由链接和占位符:
<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.定义路由的占位符 -->
<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({
routers: [// 在routers 数组中,声明路由的匹配规则
// path 表示要匹配的 hash 地址;component 表示要展示的路由组件
{path: '/home', component: Home },
{path: '/movie', component: Movie},
{path: '/about', component: About}
]
})
vue-router 的常见用法
1. 路由重定向
路由重定向
指的是:用户在访问地址 A
的时候,强制用户跳转
到地址 C ,从而展示特定的组件页面。
通过路由规则的redirect
属性,指定一个新的路由地址,可以很方便地设置路由的重定向:
const router = new VueRouter({
// 在routers 数组中,声明路由的匹配规则
routers: [
// 当用户访问 / 的时候,通过 redirect 属性跳转到 /home 对应的路由规则
{path: '/', redirect: '/home'},
{path: '/home', component: Home },
{path: '/movie', component: Movie},
{path: '/about', component: About}
]
})
2. 嵌套路由
通过路由实现组件的嵌套展示
,叫做嵌套路由。
3. 子路由和 children 属性
3.1 声明子路由链接和子路由占位符
在 About.vue 组件中,声明 tab1 和 tab2 的子路由链接以及子路由占位符。示例代码如下:
<template>
<div class="app-container">
<h1> App 组件 </h1>
<!-- 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.2 通过 children 属性声明子路由规则
在 src/router/index.js 路由模块中,导入需要的组件,并使用 children 属性声明子路由规则:
// 导入需要使用路由切换展示的组件
import Tab1 from '@/components/Tab1.vue'
import Tab2 from '@/components/Tab2.vue
const router = new VueRouter({
routers: [
{ // about 页面的路由规则(父级路由规则)
path: '/about',
componet: About,
redirect: '/about/tab1',// 默认跳转到tab1
children: [ // 1. 通过children 属性,嵌套声明子级路由规则
{path: '/tab1', component: Tab1}, // 2. 访问 Tab1 时,展示 Tab1 组件
{path: '/tab2', component: Tab2} // 2. 访问 Tab2 时,展示 Tab2 组件
]
}
]
})
// 默认子路由:如果children中,某个路由规则的path值为空字符串,则这条路由规则,叫做‘默认子路由’
4. 动态路由匹配
思考:有如下 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}
缺点:路由规则的复用性差
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 是路由的 导航对象 -->
<!-- this可省略 -->
<h1> Movie 组件 -- {{ this.$route.params.id }}</h1>
</div>
</template>
<script>
export default {
name: 'Movie'
}
</script>
4.3 使用 props 接收路由参数
为了简化路由参数的获取形式,vue-router 允许在路由规则中开启 props 传参。示例代码如下:
// 1. 可以为路由规则开启 props 传参,从而方便的拿到动态参数的值
{path: '/movie/:id', component: Movie, props: true}
<template>
<h3> MyMovie组件---{{id}}</h3>
</template>
<script>
exprot default {
props:['id]// 2. 使用props 接收路由规则中匹配到的参数项
}
</script>
4.4 扩展query和fullPath
<!-- 注意1:在 hash 地址中, / 后面的参数项,叫做“路径参数” -->
<!-- 在路由“参数对象”中,需要使用 this.$route.params 来访问路径参数 -->
<!-- 注意2:在 hash 地址中,? 后面的参数项,叫做“查询参数” -->
<!-- 在路由“参数对象”中,需要使用 this.$route.query 来访问查询参数 -->
<!-- 注意3:在 this.$route 中,path 只是路径部分;fullPath 是完整的地址 -->
<!-- 例如: -->
<!-- /movie/2?name=zs&age=20 是 fullPath 的值 -->
<!-- /movie/2 是 path 的值 -->
<router-link to="/movie/1">洛基</router-link>
<router-link to="/movie/2?name=zs&age=20">雷神</router-link>
<router-link to="/movie/3">复联</router-link>
<router-link to="/about">关于</router-link>
- 打印this图
5. 声明式导航 & 编程式导航
在浏览器中,点击链接
实现导航的方式,叫做声明式导航
。例如:
普通网页中点击
<a> 链接
、vue 项目中点击<router-link>
都属于声明式导航
在浏览器中,调用 API 方法
实现导航的方式,叫做编程式导航
。例如:
普通网页中调用
location.href
跳转到新页面的方式,属于编程式导航
5.1 vue-router 中的编程式导航 API
vue-router 提供了许多编程式导航的 API,其中最常用的导航 API 分别是:
跳转到指定 hash 地址,并增加一条历史记录
this.$router.push(‘hash 地址’)
跳转到指定的 hash 地址,并替换掉当前的历史记录
this.$router.replace(‘hash 地址’)
实现导航历史前进、后退
this.$router.go(数值 n)
5.2 $router.push
调用 this.$router.push()
方法,可以跳转到指定的 hash 地址,从而展示对应的组件页面。示例代码如下:
<template>
<div class="home-container">
<h3>Home 组件</h3>
<hr />
<button @click="gotoLk">通过 push 跳转到“洛基”页面</button>
</div>
</template>
<script>
export default {
name: 'Home',
methods: {
gotoLk() {
// 通过编程式导航 API,导航跳转到指定的页面
this.$router.push('/movie/1')
}
}
}
</script>
5.3 $router.replace
调用 this.$router.replace()
方法,可以跳转到指定的 hash 地址,从而展示对应的组件页面。
push 和 replace 的区别
:
- push 会
增加一条历史记录
- replace 不会增加历史记录,而是
替换掉当前的历史记录
<template>
<div class="home-container">
<h3>Home 组件</h3>
<hr />
<button @click="gotoLk2">通过 replace 跳转到“洛基”页面</button>
</div>
</template>
<script>
export default {
name: 'Home',
methods: {
gotoLk2() {
this.$router.replace('/movie/1')
}
}
}
</script>
5.4 $router.go
调用 this.$router.go()
方法,可以在浏览历史中前进和后退。示例代码如下:
<template>
<div class="movie-container">
<!-- this.$route 是路由的“参数对象” -->
<!-- this.$router 是路由的“导航对象” -->
<h3>Movie 组件 --- {{ $route.params.mid }} --- {{ mid }}</h3>
<button @click="showThis">打印 this</button>
<button @click="goback">后退</button>
<!-- 在行内使用编程式导航跳转的时候,this 必须要省略,否则会报错! -->
<button @click="$router.back()">back 后退</button>
<button @click="$router.forward()">forward 前进</button>
</div>
</template>
<script>
export default {
name: 'Movie',
// 接收 props 数据
props: ['mid'],
methods: {
showThis() {
console.log(this)
},
goback() {
// go(-1) 表示后退一层
// 如果后退的层数超过上限,则原地不动
this.$router.go(-1)
}
}
}
</script>
5.5 $router.go 的简化用法
在实际开发中,一般只会前进和后退一层页面。因此 vue-router 提供了如下两个便捷方法:
在历史记录中,后退到上一个页面
$router.back()
在历史记录中,前进到下一个页面
$router.forward()
6. 导航守卫
航守卫
可以控制路由的访问权限
。示意图如下:
6.1 全局前置守卫
每次发生路由的导航跳转
时,都会触发全局前置守卫
。因此,在全局前置守卫中,程序员可以对每个路由进行
访问权限
的控制:
const router = new VueRouter({...})
// 调用路由实例对象的beforeEach方法,即可声明“全局前置守卫”
// 每次发生路由导航跳转的时候,都会自动触发 fn 这个 “回调函数”
router.beforeEach(fn)
6.2 守卫方法的 3 个形参
全局前置守卫
的回调函数中接收 3 个形参,格式为:
const router = new VueRouter({...})
// 全局前置守卫
// 只要发生了路由的跳转,必然会触发 beforeEach 指定的 function 回调函数
router.beforeEach(() -> {
// to 是将要访问的路由的信息对象
// from 是将要离开的路由的信息对象
// next 是一个函数,调用 next()表示放行,允许这次路由导航
})
6.3 next 函数的 3 种调用方式
参考示意图,分析 next 函数的 3 种调用方式最终导致的结果:
当前用户拥有
后台主页的访问权限,直接放行:next()
当前用户没有
后台主页的访问权限,强制其跳转到登录页面
:next(‘/login
’)
当前用户没有
后台主页的访问权限,不允许跳转到后台主页
:next(false
)
6.4 控制后台主页的访问权限
router.beforeEach(function(to, from, next) {
if (to.path === '/main') {
// 要访问后台主页,需要判断是否有 token
const token = localStorage.getItem('token')
if (token) {
next() // 访问的是后台主页,且有 token 值
} else {
next('/login')// 访问的是后台主页,但是没有 token 的值
}
} else {
next()// 访问的不是后台主页,直接放行
}
})
6.5 例子
// 为 router 实例对象,声明全局前置导航守卫
// 只要发生了路由的跳转,必然会触发 beforeEach 指定的 function 回调函数
router.beforeEach(function(to, from, next) {
// to 表示将要访问的路由的信息对象
// from 表示将要离开的路由的信息对象
// next() 函数表示放行的意思
// 分析:
// 1. 要拿到用户将要访问的 hash 地址
// 2. 判断 hash 地址是否等于 /main。
// 2.1 如果等于 /main,证明需要登录之后,才能访问成功
// 2.2 如果不等于 /main,则不需要登录,直接放行 next()
// 3. 如果访问的地址是 /main。则需要读取 localStorage 中的 token 值
// 3.1 如果有 token,则放行
// 3.2 如果没有 token,则强制跳转到 /login 登录页
if (to.path === '/main') {
// 要访问后台主页,需要判断是否有 token
const token = localStorage.getItem('token')
if (token) {
next()
} else {
// 没有登录,强制跳转到登录页
next('/login')
}
} else {
next()
}
})
后台管理案例
总结
① 能够知道如何在 vue 中配置路由
- createRouter、app.use(router)
② 能够知道如何使用嵌套路由
- 通过 children 属性进行路由嵌套
③ 能够知道如何实现动态路由匹配
- 使用冒号声明参数项、this.$route.params、props: true
④ 能够知道如何使用编程式导航
- this. r o u t e r . p u s h 、 t h i s . router.push、this. router.push、this.router.go
⑤ 能够知道如何使用导航守卫
- 路由实例.beforeEach((to, from, next) => { /* 必须调 next 函数 */ })