1. vue-router的理解
vue的一个插件库,专门用来实现SPA应用。
对SPA应用的理解
- 单页Web应用(single page web application,SPA)
- 整个应用只有一个完整的页面
- 点击页面中的导航链接不会刷新页面,只会做页面的局部更新
- 数据需要通过Ajax请求获取
2. 路由的理解
- 什么是路由?
- 一个路由就是一组映射关系(key - value)
- key 为路径, value 可能是 function 或 component
- 路由分类
- 后端路由
- 理解:value是function,用于处理客户端提交的请求
- 工作过程:服务器收到一个请求时,根据请求路径找到匹配的函数来处理,返回响应式数据
- 前端路由:
- 理解:value是component,用于展示页面内容
- 工作过程:当浏览器的路径改变时,对应的组件就会显示
- 后端路由
3. 路由的基本使用
安装router依赖包
vue-router的默认版本为4,vue2要使用router@3
npm i vue-router@3
在main.js中配置
import Vue from 'vue'
import App from './App.vue'
// 引入VueRouter
import VueRouter from 'vue-router'
// 引入路由器
import router from './router/index.js'
Vue.config.productionTip = false
Vue.use(VueRouter)
new Vue({
router,
render: (h) => h(App),
}).$mount('#app')
在src中创建router文件夹,在index.js中配置
// 该文件专门用于创建整个应用的路由器
import VueRouter from 'vue-router'
import About from '../pages/About.vue'
// 创建并暴露一个路由器
export default new VueRouter({
routes: [
{
path: '/about',
component: About,
},
{
path: '/home',
component: () => import('../pages/Home.vue'),
},
],
})
实现切换(active-class可配置高亮样式)
<router-link active-class="active" to="/about">About</router-link>
指定组件展示位置
<router-view></router-view>
注意点:
- 路由组件通常存放在pages文件夹,一般组件通常存放在components文件夹。
- 通过切换,“隐藏”了的路由组件,默认是被销毁掉的,需要的时候再去挂载。
- 每个组件都有自己的
$route
属性,里面存储着自己的路由信息。 - 整个应用只有一个router,可以通过组件的
$router
属性获取到。
4. 嵌套(多级)路由
1.配置路由规则,使用children配置项
routes: [
{
path: '/about',
component: About,
},
{
path: '/home',
component: () => import('../pages/Home.vue'),
children: [
{
// 子路由不用加斜杠 /
path: 'message',
component: Message,
},
{
path: 'new',
component: New,
},
],
},
],
2.跳转要写完整路径
<router-link class="list-group-item" active-class="active" to="/home/new">New</router-link>
5. 路由的query参数
- 传递参数
<template>
<div>
<ul>
<li v-for="item in messageList" :key="item.id">
<!-- 跳转路由并携带query参数,to的字符串写法 -->
<router-link :to="`/home/message/detail?id=${item.id}&title=${item.title}`">{{ item.title }}</router-link>
<!-- 跳转路由并携带query参数,to的对象写法 -->
<router-link
:to="{
path: '/home/message/detail',
query: {
id: item.id,
title: item.title,
},
}"
>
{{ item.title }}
</router-link>
</li>
</ul>
<hr />
<router-view></router-view>
</div>
</template>
<script>
export default {
// eslint-disable-next-line vue/multi-word-component-names
name: 'Message',
data() {
return {
messageList: [
{ id: '001', title: '消息001' },
{ id: '002', title: '消息002' },
{ id: '003', title: '消息003' },
],
}
},
}
</script>
- 接收参数
$route.query.id
$route.query.title
6. 命名路由
1.作用:可以简化路由的跳转。
2.如何使用:
-
给路由命名:
{ path: '/demo', component: Demo, children: [ { path: 'test', component: Test, children: [ { name: 'hello', //给路由命名 path: 'welcome', component: Hello, } ] } ] }
-
简化跳转:
<!-- 简化前,需要写完整的路径 -->
<router-link to="/demo/test/welcome">跳转</router-link>
<!-- 简化后,直接通过名字跳转 -->
<router-link :to="{ name:'hello' }">跳转</router-link>
<!-- 简化写法配合传递参数 -->
<router-link
:to="{
path: '/home/message/detail',
query: {
id: 666,
title: '你好啊',
},
}"
>跳转</router-link>
7. 路由的params参数
1.配置路由,声明接收params参数
{
path: '/home',
component: Home,
children: [
{
path: 'news',
component: News,
},
{
component: Message,
children: [
{
name: 'xiangqing',
path: 'detail/:id/:title', //使用占位符声明接收params参数
component: Detail,
}
]
}
]
}
2.传递参数
<!-- 跳转路由并携带params参数,to的字符串写法 -->
<router-link :to="/home/message/detail/666/你好">跳转</router-link>
<!-- 跳转路由并携带params参数,to的对象写法 -->
<router-link
:to="{
name: 'xiangqing',
params: {
id: 666,
title: '你好',
},
}"
>跳转</router-link>
注意:路由携带params参数时,若使用to的对象写法,则不能使用path配置项,必须使用name配置。
3.接收参数
$route.params.id
$route.params.title
8. 路由的props配置
作用:让路由组件更方便的收到参数。
{
path: 'detail',
component: Detail,
// props的第一种写法,值为对象,该对象中的所有key-value都会以props的形式传给Detail组件
// props: { a: 1, b: 'hello' },
// props的第二种写法,值为布尔值,若布尔值为真,就会把该路由组件收到的所有params参数,以props的形式传给Detail组件
// props: true,
// props的第三种写法,值为函数
props($route) {
return {
id: $route.query.id, title: $route.query.title
}
},
// props({query:{id,title}}) {
// return { id, title}
// },
// props({query}) {
// return { id:query.id, title:query.title}
// },
},
然后在Detail组件配置props: ['id','title']
接收
9. <router-link>
的replace属性
- 作用:控制路由跳转时操作浏览器历史记录的模式
- 浏览器的历史记录有两种写入方式:分别为
push
和replace
,push
是追加历史记录,replace
是替换当前记录。路由跳转时候默认为push
- 如何开启
replace
模式:<router-link replace ....><router-link>
10. 编程式路由导航
1.作用:不借助<router-link>
实现路由跳转,让路由跳转更加灵活。
2.具体编码:
// $router的两个API
this.$router.push({
path: '/home/message/detail',
query: {
id: xxx,
title: xxx,
},
})
this.$router.replace({
name: 'xiangqing',
params: {
id: xxx,
title: xxx,
},
})
this.$router.back() //后退
this.$router.forward() //前进
this.$router.go() //可前进可后退
11. 缓存路由组件
1.作用:让不展示的路由组件保持挂载,不被销毁。
2.具体编码:
<keep-alive include="New">
<router-view></router-view>
</keep-alive>
12. 两个新的生命周期钩子
1.作用:路由组件所独有的两个狗子,用于捕获路由组件的激活状态。
2.具体名字:
activated
:路由组件被激活时触发deactivated
:路由组件失活时触发
13. 路由守卫
1.作用:对路由进行权限控制
2.分类:全局守卫、独享守卫、组件内守卫
3.全局守卫:
// 全局前置路由守卫————初始化的时候被调用,每次路由切换之前被调用
router.beforeEach((to, from, next) => {
if (meta.isAuth) {
// 判断当前路由是否需要进行权限控制
if (localStorage.getItem('token')) {
document.title = to.meta.title || 'fg系统'
next() //放行
}
}
})
// 全局后置路由守卫————初始化的时候被调用,每次路由切换之后被调用
router.afterEach((to, from) => {
console.log('后置路由', to, from)
document.title = to.meta.title || 'fg系统'
})
4.独享守卫
beforeEnter: (to, from, next) => {
console.log('独享路由', to, from)
if (meta.isAuth) {
// 判断当前路由是否需要进行权限控制
if (localStorage.getItem('token')) {
document.title = to.meta.title || 'fg系统'
next() //放行
}
}
}
5.组件内守卫
// 进入守卫,通过路由规则,进入该组件时被调用
beforeRouteEnter(to,from,next) {},
// 进入守卫,通过路由规则,离开该组件时被调用
beforeRouteLeave(to,from,next) {},
14. 案例源码
main.js
import Vue from 'vue'
import App from './App.vue'
// 引入VueRouter
import VueRouter from 'vue-router'
// 引入路由器
import router from './router/index.js'
Vue.config.productionTip = false
Vue.use(VueRouter)
new Vue({
router,
render: (h) => h(App),
}).$mount('#app')
App.vue
<template>
<div>
<div class="row">
<div class="col-xs-offset-2 col-xs-8">
<div class="page-header">
<h2>Vue Router Demo</h2>
<button @click="back">后退</button>
<button @click="forward">前进</button>
<button @click="test">测试一下go</button>
</div>
</div>
</div>
<div class="row">
<div class="col-xs-2 col-xs-offset-2">
<div class="list-group">
<!-- 原始HTML中使用a标签实现页面的跳转 -->
<!-- <a class="list-group-item active" href="./about.html">About</a> -->
<!-- <a class="list-group-item" href="./home.html">Home</a> -->
<!-- Vue中借助router-link标签实现路由的切换 -->
<router-link class="list-group-item" active-class="active" to="/about">About</router-link>
<router-link class="list-group-item" active-class="active" to="/home">Home</router-link>
</div>
</div>
<div class="col-xs-6">
<div class="panel">
<div class="panel-body">
<!-- 指定组件的呈现位置 -->
<router-view></router-view>
</div>
</div>
</div>
</div>
</div>
</template>
<script>
export default {
name: 'App',
methods: {
back() {
this.$router.back()
},
forward() {
this.$router.forward()
},
test() {
this.$router.go(3)
},
},
}
</script>
router/index.js
// 该文件专门用于创建整个应用的路由器
import VueRouter from 'vue-router'
import About from '../pages/About.vue'
import Message from '../pages/Message.vue'
import New from '../pages/New.vue'
import Detail from '../pages/Detail.vue'
// 创建并暴露一个路由器
const router = new VueRouter({
routes: [
{
path: '/about',
component: About,
meta: { isAuth: true, title: '关于' },
},
{
path: '/home',
component: () => import('../pages/Home.vue'),
meta: { title: '主页' },
children: [
{
path: 'new',
component: New,
meta: { isAuth: true, title: '新闻' },
beforeEnter: (to, from, next) => {
console.log('独享路由', to, from)
if (localStorage.getItem('token')) {
next()
}
},
},
{
// 子路由不用加斜杠 /
path: 'message',
component: Message,
children: [
{
path: 'detail',
component: Detail,
meta: { isAuth: true, title: '消息' },
// props的第一种写法,值为对象,该对象中的所有key-value都会以props的形式传给Detail组件
// props: { a: 1, b: 'hello' },
// props的第二种写法,值为布尔值,若布尔值为真,就会把该路由组件收到的所有params参数,以props的形式传给Detail组件
// props: true,
// props的第二种写法,值为函数
props(route) {
return { id: route.query.id, title: route.query.title }
},
},
],
},
],
},
],
})
// // 全局前置路由守卫————初始化的时候被调用,每次路由切换之前被调用
// router.beforeEach((to, from, next) => {
// if (meta.isAuth) {
// 判断是否需要鉴权
// if (localStorage.getItem('token')) {
// document.title = to.meta.title || 'fg系统'
// next()
// }
// }
// })
// 全局后置路由守卫————初始化的时候被调用,每次路由切换之后被调用
router.afterEach((to, from) => {
console.log('后置路由', to, from)
document.title = to.meta.title || 'fg系统'
})
export default router
pages/Home.vue
<template>
<div>
<h2>我是Home组件</h2>
<div>
<ul class="nav nav-tabs">
<li>
<router-link class="list-group-item" active-class="active" to="/home/new">New</router-link>
</li>
<li>
<router-link class="list-group-item" active-class="active" to="/home/message">Message</router-link>
</li>
</ul>
<keep-alive include="New">
<router-view></router-view>
</keep-alive>
</div>
</div>
</template>
<script>
export default {
// eslint-disable-next-line vue/multi-word-component-names
name: 'Home',
}
</script>
pages/About.vue
<template>
<h2>我是About组件</h2>
</template>
<script>
export default {
// eslint-disable-next-line vue/multi-word-component-names
name: 'About',
// 通过路由规则,进入该组件时被调用
beforeRouteEnter(to, from, next) {
console.log('About---beforeRouteEnter', to, from)
if (to.meta.isAuth) {
// 判断是否需要鉴权
if (localStorage.getItem('token')) {
document.title = to.meta.title || 'fg系统'
next()
}
}
},
// 通过路由规则,离开该组件时被调用
beforeRouteLeave(to, from, next) {
console.log('About---beforeRouteLeave', to, from)
next()
},
}
</script>
pages/New.vue
<template>
<div>
<ul>
<li>news001<input type="text" /></li>
<li>news002<input type="text" /></li>
<li>news003<input type="text" /></li>
</ul>
</div>
</template>
<script>
export default {
// eslint-disable-next-line vue/multi-word-component-names
name: 'New',
}
</script>
pages/Message.vue
<template>
<div>
<ul>
<li v-for="item in messageList" :key="item.id">
<!-- 跳转路由并携带query参数,to的字符串写法 -->
<!-- <router-link :to="`/home/message/detail?id=${item.id}&title=${item.title}`">{{ item.title }}</router-link> -->
<!-- 跳转路由并携带query参数,to的对象写法 -->
<router-link
:to="{
path: '/home/message/detail',
query: {
id: item.id,
title: item.title,
},
}"
>
{{ item.title }}
</router-link>
<button @click="pushShow(item)">push查看</button>
<button @click="replaceShow(item)">replace查看</button>
</li>
</ul>
<hr />
<router-view></router-view>
</div>
</template>
<script>
export default {
// eslint-disable-next-line vue/multi-word-component-names
name: 'Message',
data() {
return {
messageList: [
{ id: '001', title: '消息001' },
{ id: '002', title: '消息002' },
{ id: '003', title: '消息003' },
],
}
},
methods: {
pushShow(item) {
this.$router.push({
path: '/home/message/detail',
query: {
id: item.id,
title: item.title,
},
})
},
replaceShow(item) {
this.$router.replace({
path: '/home/message/detail',
query: {
id: item.id,
title: item.title,
},
})
},
},
}
</script>
pages/Detail.vue
<template>
<ul>
<li>消息编号:{{ id }}</li>
<li>消息标题:{{ title }}</li>
</ul>
</template>
<script>
export default {
// eslint-disable-next-line vue/multi-word-component-names
name: 'Detail',
props: ['id', 'title'],
// mounted() {
// console.log(this.$route)
// },
}
</script>