- 路由(route)就是一组 key-value 的对应关系
- 多个路由,需要经过路由器(router)的管理
在 Vue 中也有路由,Vue 中的路由主要是通过 vue-rounter 这个插件库来实现,它的作用就是专门用来实现 SPA 应用的。
对 SPA 应用的理解:
- 单页 Web 应用(single page web application,SPA)
- 整个应用只有一个完整的页面
- 点击页面中的导航链接不会刷新页面,只会做页面的局部更新
- 数据需要通过 Ajax 请求获取
注意事项
- 路由组件通常存放在 pages 文件夹,一般组件通常存放在 components 文件夹
- 通过切换,"隐藏"了路由组件,默认是被销毁的,需要的时候再去挂载
- 每个组件都有自己的 $route 属性,里面存储着自己的路由信息
- 整个应用只有一个 router 路由器,可以通过组件的 $router 属性获取到
1- 安装 并引入 vue-router
Vue 2
:安装vue-router 3
Vue 3
:安装vue-router 4
我们现在学习所用的
Vue
的版本是 2 版本,所以我们需要使用如下命令安装vue-router 3
npm install vue-router@3
在 /src/router/index.js
中创建整个应用的路由器
// 该文件专门用于创建整个路由器
import VueRouter from 'vue-router'
// 引入组件
import About from '../pages/About'
import Home from '../pages/Home'
// 创建并暴露一个路由器
export default new VueRouter({
routes:[
{
path:'/about',
component:About
},
{
path:'/home',
component:Home
}
]
})
在
src/main.js
中引入和使用该插件 vue-router ,步骤 1和 1-1在
src/main.js
中引入路由器,并添加暴露出来,步骤 2 和 3
import Vue from 'vue'
import App from './App.vue'
// 1- 引入 vue-router
import VueRouter from 'vue-router'
// 2-引入路由器
import router from './router'
// 1-1应用 vue-router
Vue.use(VueRouter)
Vue.config.productionTip = false
new Vue({
render: h => h(App),
// 3-在 vm 中添加路由器
router:router
}).$mount('#app')
APP组件中
配置跳转连接 ,router-link
最终会在vue-router
的作用下转换为a
标签标签展示页面 - 以及 active-class="active" 完成下面的效果
Vue Router Demo
About
Home
./src/pages 文件夹下面新建About组件 和Home组件(2个一样)
我是About的内容
完成如下效果,在Home组件下面添加子路由
src\router\index.js 配置多级路由,如下 1 、2处
注意:
- children 属性配置多级路由
- 一级路由后面的二级路由、三级路由等前面都不需要添加斜
// 该文件专门用于创建整个路由器
import VueRouter from 'vue-router'
// 引入组件
import About from '../pages/About'
import Home from '../pages/Home'
import Message from '../pages/Message'
import News from '../pages/News'
// 创建并暴露一个路由器
export default new VueRouter({
routes: [
{
path: '/about',
component: About
},
{
path: '/home',
component: Home,
// 1- 通过children 配置子级路由
children: [
{
path: 'message', //2 一级路由后面的二级路由、三级路由等前面都不需要添加斜杆'/'
component: Message
},
{
path: 'news',
component: News
},
]
}
]
})
Home组件下面代码,如下
注意 :
to="/home/news 要匹配到 路由
Home组件内容
Message 、News组件 如下
message 组件,像detail传递参数 2种写法
- 模板字符串写法
- 对象写法
-
{{ m.title }}
{{m.title}}
detail 接受参数 $route 中获取
- 消息编号:{{ $route.query.id }}
- 消息内容:{{ $route.query.title }}
给路由设置name属性,命名
// 该文件专门用于创建整个路由器
import VueRouter from 'vue-router'
// 引入组件
import About from '../pages/About'
import Home from '../pages/Home'
import Message from '../pages/Message'
import News from '../pages/News'
import Detail from '../pages/Detail'
export default new VueRouter({
routes: [
{
// 1- 给about路由命名
name:'guanyu',
path: '/about',
component: About
},
{
path: '/home',
component: Home,
children: [
{
path: 'message',
component: Message,
children: [
{
path: 'detail',
component: Detail
}
]
},
{
path: 'news',
component: News
},
]
}
]
})
跳转处写法
About
params 传递参数的2种写法
1- 模板字符串
2- 对象写法 (注意: path 会报错,只能用name 去跳转)
-
{{ m.title }}
{{m.title}}
src\router\index.js 路由文件的写法
// 该文件专门用于创建整个路由器
import VueRouter from 'vue-router'
// 引入组件
import About from '../pages/About'
import Home from '../pages/Home'
import Message from '../pages/Message'
import News from '../pages/News'
import Detail from '../pages/Detail'
export default new VueRouter({
routes: [
{
name:'guanyu',
path: '/about',
component: About
},
{
path: '/home',
component: Home,
children: [
{
path: 'message',
component: Message,
children: [
{
//1- params 参数定义
name:'xiangqing',
//2- 声明占位 传递参数
path: 'detail/:id/:title',
component: Detail
}
]
},
{
path: 'news',
component: News
},
]
}
]
})
Detail组件接受参数
消息编号:{{ $route.params.id }}
消息内容:{{ $route.params.title }}
作用:让路由组件更方便收到值
- 写法一只能配置并传递固定数据
- 写法二只能接收路由传递过来的 params 参数
- 写法三灵活性最大,可以通过
$route
来传递query
或者params
参数
src\router\index.js 文件中 props 三种写法
// 该文件专门用于创建整个路由器
import VueRouter from 'vue-router'
// 引入组件
import About from '../pages/About'
import Home from '../pages/Home'
import Message from '../pages/Message'
import News from '../pages/News'
import Detail from '../pages/Detail'
export default new VueRouter({
routes: [
{
name: 'guanyu',
path: '/about',
component: About
},
{
path: '/home',
component: Home,
children: [
{
path: 'message',
component: Message,
children: [
{
name: 'xiangqing',
path: 'detail/:id/:title',
component: Detail,
//1- props 第一种写法 ,传递对象
// props:{a:100,b:'message100'}
//2-props 第二种写法 ,布尔值为真,把路由收到params参数按照props传给组件
// props: true
// 第三种写法,props 值为函数,该函数返回的对象中每一组 key-value 都会通过 props 传给 Detail 组件
// query传参
// {{m.title}}
props($route) {
return {
id: $route.query.id,
title: $route.query.title,
}
}
}
]
},
{
path: 'news',
component: News
},
]
}
]
})
Detail 接受参数的写法
- 消息编号:{{id }}
- 消息内容:{{title }}
作用:控制路由跳转时操作浏览器历史记录的模式
浏览器的历史记录有两种写入方式:
push
是追加历史记录replace
是替换当前历史记录- 路由跳转时默认是
push
开启replace 模式
News
作用:不借助
实现路由跳转,让路由跳转更加灵活
message组件编写按钮跳转路由 借,助this.$router 中的提供的api实现,如下 1、 2 代码处
-
{{ m.title }}
$router
路由器中还有如下的 API 可供我们前进和回退浏览器器历史记录
- this.$router.forward() // 前进
- this.$router.back() // 后退
- this.$router.go(num) // 前景或后退
Vue Router Demo
作用:让不展示的路由组件保持挂载,不被销毁
- keep-alive 中不添加 include,那么将使得挂载到 router-view 中路由每次切换时都不会被销毁
- keep-alive 的 include 的参数值为组件名,而不是路由名
- 如果想要缓存多个组件,那么 include 里面的路由需要写成数组形式,例如 :include="['News', 'Message']"
多个
作用:路由组件所独有的两个钩子函数,用于捕获路由组件的激活状态
activated
:路由组件被激活时触发deactivated
:路由组件失活时触发
- news001
- news002
- news003
- VUE生命周期
1- router.beforeEach((to, from, next) => {…}):全局前置守卫配置
- to:目标路由
- from:源路由
- next:是一个回调函数,对后续的执行操作起着拦截或放行的作用
2- router.afterEach((to, from) => {…}):全局后置守卫配置
- to:目标路由
- from:源路由
使用场景
- 前置守卫适用于路由改变前的操作,可以根据权限判断是否展示对应路由的信息
- 后置守卫适用于路由改变后的操作,可以根据是否进入对应路由来执行相应的操作
下面展示点单DEMO 如 1、2、3处代码
// 该文件专门用于创建整个路由器
import VueRouter from 'vue-router'
// 引入组件
import About from '../pages/About'
import Home from '../pages/Home'
import Message from '../pages/Message'
import News from '../pages/News'
import Detail from '../pages/Detail'
const router = new VueRouter({
routes: [
{
name: 'guanyu',
path: '/about',
component: About,
meta:{
isAuth:false, //1- 用于表示该路由是否需要进行权限判断
}
},
{
name:'zhuye',
path: '/home',
component: Home,
children: [
{
path: 'message',
component: Message,
children: [
{
name: 'xiangqing',
path: 'detail/:id/:title',
component: Detail,
props($route) {
return {
id: $route.query.id,
title: $route.query.title,
}
}
}
]
},
{
path: 'news',
component: News
},
]
}
]
})
// 2-全局前置路由守卫 —— 初始化的时候被调用以及每次路由切换的时候都会调用一次
router.beforeEach((to, from, next) => {
console.log('前置守卫', to, from)
if(to.meta.isAuth) { // 判断是否需要授权
if(localStorage.getItem('school') === 'atguigu') {
next()
} else {
alert('学校名不对,无权查看')
}
} else {
next() // 不需要判断权限的路由直接放行
}
})
// 3-全局后置路由守卫
router.afterEach((to, from) => { // 该配置是为了每次路由跳转的时候进行标签名的更新
console.log('后置路由守卫', to, from);
if(to.meta.title) {
document.title = to.meta.title // 如果 meta 中配置了路由的 title,那么就修改
} else {
document.title = 'vue-test'
}
})
export default router;
作用:只对单个路由进行的守卫
独享路由守卫的配置函数为
beforeEnter((to, from, next) => {…})
,是在 route 中进行配置。如图代码1处:
// 该文件专门用于创建整个路由器
import VueRouter from 'vue-router'
// 引入组件
import About from '../pages/About'
import Home from '../pages/Home'
import Message from '../pages/Message'
import News from '../pages/News'
import Detail from '../pages/Detail'
const router = new VueRouter({
routes: [
{
name: 'guanyu',
path: '/about',
component: About,
meta:{
isAuth:false,
}
},
{
name:'zhuye',
path: '/home',
component: Home,
children: [
{
path: 'message',
component: Message,
children: [
{
name: 'xiangqing',
path: 'detail/:id/:title',
component: Detail,
props($route) {
return {
id: $route.query.id,
title: $route.query.title,
}
}
}
]
},
{
path: 'news',
component: News,
//1-独享路由守卫
beforeEnter(to, from, next) {
console.log('独享路由守卫', to, from)
if(to.meta.isAuth) { // 判断是否需要授权
if(localStorage.getItem('school') === 'atguigu') {
next()
} else {
alert('学校名不对,无权查看')
}
} else {
next() // 不需要判断权限的路由直接放行
}
}
},
]
}
]
})
export default router;
作用:主要针对组件而言,在组件之间切换时触发的守卫
- // 进入守卫,通过路由规则,进入该组件时被调用 beforeRouteEnter(to, from, next) {},
- // 离开守卫,通过路由规则,离开该组价时被调用 beforeRouteLeave(to, from, next) {},
我是About的内容
- history 模式
- hash 模式
对于一个 url 来说,hash 指的就是
#
后面的内容,hash 值不会包含在 HTTP 请求中,即 hash 值不会带给服务器特点
1-hash 模式(默认)
地址中永远带这 # 号,不美观
若以后将地址通过第三方手机 app 分享,若 app 检验严格,则地址会被标记为不合法
2-history 模式
地址干净、美观
兼容性和 hash 模式相比略差
应用部署上线时需要后端人员支持,解决刷新页面服务器 404 的问题(一般 nginx 解决)
1- 修改模式方法
在创建路由器 router 对象实例中添加
mode:history
或者mode:hash
来将路由模式修改为history
或hash
模式
const router = new VueRouter({
mode:'history',
routes: […]
})
了演示 hash 模式下,hash 值不会带给服务器,我们需要将之前制作的 SPA 进行打包,打包命令如下:
npm run build
稍事等待,待打包完毕后,生成的文件在 /dist
文件夹中,生成的目录结构如下:
dist
├─ css
│ └─ bootstrap.css
├─ js
│ ├─ app.adc4f030.js
│ ├─ app.adc4f030.js.map
│ ├─ chunk-vendors.7c6bdce6.js
│ └─ chunk-vendors.7c6bdce6.js.map
├─ favicon.ico
└─ index.html
上面打包文件,直接打开 index.html ,肯定是浏览器不了的,需要将打包的文件放到服务器中服务才能运行,所以我们现在来使用 node.js 和 express 来编写一个服务器
1-安装 express 框架,npm i express
2-编写一个服务器主文件
/server.js
const express = require('express') // 使用 common.js 的语法来引入 express 框架
// 创建 app 服务实例对象
const app = express()
// 指定静态资源
app.use(express.static(__dirname + '/static'))
// 搭建路由
app.get('demo', (req, res) => {
res.send({
name:'tom',
age:18,
})
})
app.listen(5005, (err) => {
if(!err) {
console.log('服务器启动成功');
}
})
新建一个 static 文件夹,用于存放静态资源,将生成好的 dist 文件夹中的内容放置到 static 中
启动服务器:
node server
在浏览器中输入
localhost:5005
打开部署好的页面
如果面对 history 模式,我们也有自己的解决方法,首先去 npm 包管理平台 下载 connect-history-api-fallback,或者使用如下命令安装:
npm i connect-history-api-fallback
const history = require('connect-history-api-fallback')
// 注释使用 history 的时机,需要在创建 app 实例之后,在挂载静态资源之前
app.use(history())