主要技术点
1、mock.js模拟响应ajax请求
2、通过js代码完成路由的跳转
3、后台主界面的搭建
4、退出功能
5、左侧树收缩功能(vue总线的概念)
Mock.js
技术背景
前后端分离开发开发过程当中,经常会遇到以下几个尴尬的场景:
- 老大,接口文档还没输出,我的好多活干不下去啊!
- 后端小哥,接口写好了没,我要测试啊!
前后端分离之后,前端迫切需要一种机制,不再需要依赖后端接口开发,而今天的主角mock.js就可以做到这一点
Mock.js 介绍
Mock.js是一个模拟数据的生成器,用来帮助前端调试开发、进行前后端的原型分离以及用来提高自动化测试效率。
Mock.js因为两个重要的特性风靡前端:
数据类型丰富
: 支持生成随机的文本、数字、布尔值、日期、邮箱、链接、图片、颜色等。
拦截Ajax请求
不需要修改既有代码,就可以拦截Ajax请求,返回模拟的响应数据。
更多内容,可以云Mockjs官方查看“http://mockjs.com/”
注1:easy-mock,一个在线模拟后台的数据平台
Mock.js使用步骤
安装mockjs依赖
npm install mockjs -D #只在开发环境使用
引入
因为了只在开发环境使用mock,而打包到生产环境时自动不使用mock,我们可以在env中做一个配置
dev.env
module.exports = merge(prodEnv, {
NODE_ENV: '"development"',
MOCK: 'true'
})
prod.env
module.exports = {
NODE_ENV: '"production"',
MOCK: 'false'
}
main.js
process.env.MOCK && require('@/mock') //开发环境下才会引入mockjs
注1:import是ES6标准中的模块化解决方案,require是node中遵循CommonJS规范的模块化解决方案后者支持动态引入,也就是require(${path}/xx.js)
目录和文件创建
先展示一下创建好的目录结构:
在src目录下创建mock目录,定义mock主文件index.js,并在该文件中定义拦截路由配置
/src/mock/index.js
import Mock from 'mockjs' //引入mockjs,npm已安装
import action from '@/api/action' //引入请求地址
///全局设置:设置所有ajax请求的超时时间,模拟网络传输耗时
Mock.setup({
// timeout: 400 //延时400s请求到数据
timeout: 200 - 400 //延时200-400s请求到数据
})
//引登陆的测试数据,并添加至mockjs
import loginInfo from '@/mock/json/login-mock.js'
let s1 = action.getFullPath('SYSTEM_USER_DOLOGIN')
// Mock.mock(s1, "post", loginInfo)
//这里将请求 loginInfo 中的数据
Mock.mock(s1, /post|get/i, loginInfo)
注1:index.js文件的作用很显然,就是将分散的xxx-mock文件集合起来.后面再添加新的mock文件,都需要在这里引入
注2:如何同时拦截get/post请求,并对get和post请求大小写不敏感呢?那就请使用正则表达式吧
Mock.mock(url, /post|get/i,{})
注3:Mockjs如何拦截带参数的GET请求
在实践过程中,发现mockjs对GET请求的支持并不是很友好。例如:使用 Mock.mock("/user/getUserInfo", “get”, mockData) 的时候,它只会拦截url等于 /user/getUserInfo 的请求,而对于带参数的请求,如/user/getUserInfo?id=12,因为不等于 /user/getUserInfo 就拦截不到。
解决方案:通过正则表达式实现
Mock.mock(RegExp(url + “.*”), /post|get/i, {…});
注4:定义拦截路由配置最简单的方式就是使用POST请求,并且不在URL中添加参数(推荐)
注5:还可以通过控制台将将请求和参数都打印出来,以便调试
Mock.mock(url, "get", (options) =>{
// 最佳实践,
console.debug(url, options);
return Mock.mock(mockUserInfo);
});
login-mock.js文件
ps: 为每个*.vue定义单独的xxx-mock.js文件
//可以添加自定义的json数据
// const loginInfo = {
// code: 0,
// msg: '密码错误'
// }
//使用mockjs的模板生成随机数据
const loginInfo = {
'code|0-1': 0,
'msg|3-10': 'msg'
}
export default loginInfo;
注1:可以添加自定义的json数据
注2:还可以通过mockjs的模板生成随机数据
配置好之后ajax请求便会被mock拦截了
SPA项目开发之首页导航+左侧菜单 实现
登陆与注册页面的跳转
使用this.$router.push({})实现路由跳转
字符串
this.$router.push('/home/first')
对象
this.$router.push({ path: '/home/first' })
命名的路由
this.$router.push({ name: 'home', params: { userId: wise }})
this.$router.push、replace、go的区别
跳转到不同的url,但这个方法会向history栈添加一个记录,点击后退会返回到上一个页面
this.$router.push()
同样是跳转到指定的url,但是这个方法不会向history里面添加新的记录,点击返回,会跳转到上上一个页面。上一个记录是不存在的。
this.$router.replace()
相对于当前页面向前或向后跳转多少个页面,类似 window.history.go(n)。n可为正数可为负数。负数返回上一个页面
this.$router.go(n)
这里展示一下登录界面的代码(仅js代码):
<script>
export default {
data() {
return {
ruleForm: {
uname: '',
pwd: ''
}
}
},
methods: {
//跳转到注册页面的方法
toReg() {
this.$router.push({
path: '/Reg'
})
},
//这是登录的回掉
doLogin() {
//获取配置文件中对应的请求路径
let url = this.axios.urls.SYSTEM_USER_DOLOGIN;
//发送post请求
this.axios.post(url, this.ruleForm).then((response) => {
console.log(response);
if (response.data.code == 1) {
this.$message({
message: '登录成功,牛逼',
type: 'success'
});
//跳转页面 这里通过 this.$router.push这种方式跳转
this.$router.push({
path: '/AppMain'
})
} else {
this.$message.error(response.data.msg);
}
}).catch((response) => {
console.log(response);
});
}
}
}
</script>
AppMain.vue、TopNav.vue、LeftNav.vue 的创建和配置
AppMain.vue(布局容器,导航条和左侧菜单组件都写在里面)
<template>
<el-container class="main-container">
<el-aside :class="asideClass">
<LeftNav></LeftNav>
</el-aside>
<el-container>
<el-header class="main-header">
<TopNav></TopNav>
</el-header>
<el-main class="main-center">Main</el-main>
</el-container>
</el-container>
</template>
<script>
import ElementUI from 'element-ui' //新添加1
import TopNav from '@/components/TopNav.vue'
import LeftNav from '@/components/LeftNav.vue'
export default {
name: 'AppMain',
data: function() {
return {
ts: new Date().getTime(),
collapsed:false
}
},
computed:{
asideClass:function(){
return this.collapsed ? 'main-aside-collapsed' : 'main-aside';
}
},
components:{
TopNav,LeftNav
},
created: function() {
// 监听collapsed-toggle事件 这个是为了整个左侧导航菜单收缩起来
this.$root.Bus.$on("collapsed-toggle", (v) => {
//注意asideClass这个计算属性: 当 collapsed 改变的时候 asideClass 也会跟着变
this.collapsed = v;
});
}
}
</script>
<!-- Add "scoped" attribute to limit CSS to this component only -->
<style scoped>
.main-container {
height: 100%;
width: 100%;
box-sizing: border-box;
}
.main-aside-collapsed {
/* 在CSS中,通过对某一样式声明! important ,可以更改默认的CSS样式优先级规则,使该条样式属性声明具有最高优先级 */
width: 64px !important;
height: 100%;
background-color: #334157;
margin: 0px;
}
.main-aside {
width: 240px !important;
height: 100%;
background-color: #334157;
margin: 0px;
}
.main-header,
.main-center {
padding: 0px;
border-left: 2px solid #333;
}
</style>
TopNav.vue
这是顶部导航条
<template>
<el-menu class="el-menu-demo" mode="horizontal" background-color="#334157" text-color="#fff" active-text-color="#fff">
<el-button class="buttonimg">
<!-- <img class="showimg" src="../assets/img/show.png" @click="doToggle()"> -->
<!-- 点击按钮的时候会打开或收缩左侧菜单栏 -->
<img class="showimg" :src="collapsed?imgshow:imgsq" @click="doToggle()">
</el-button>
<el-submenu index="2" class="submenu">
<template slot="title">超级管理员</template>
<el-menu-item index="2-1">设置</el-menu-item>
<el-menu-item index="2-2">个人中心</el-menu-item>
<el-menu-item @click="exit()" index="2-3">退出</el-menu-item>
</el-submenu>
</el-menu>
</template>
<script>
export default {
name: 'TopNav',
data: function() {
return {
collapsed: false,
/*
这里引入图的方式 通过 require
require是node中遵循CommonJS规范的模块化解决方案、支持动态引入,
也就是require(${path}/xx.js)
*/
imgshow: require('../assets/img/show.png'),
imgsq: require('../assets/img/sq.png')
};
},
methods: {
doToggle: function() {
this.collapsed = !this.collapsed;
//触发事件 事件名 和 传递的参数
this.$root.Bus.$emit('collapsed-toggle', this.collapsed);
},
exit: function() {
this.$confirm('退出系统, 是否继续?', '提示', {
//定义两个按钮 确定和取消
confirmButtonText: '确定',
cancelButtonText: '取消',
type: 'warning'
}).then(() => {
//如果退出就跳转到登录界面(当点击确定按钮的时候触发)
this.$router.push({
path: '/Login'
});
this.$message({
type: 'success',
message: '退出成功!'
});
}).catch(() => {
//当点击取消按钮的时候会触发
this.$message({
type: 'info',
message: '退出操作取消'
});
});
}
}
}
</script>
<style scoped>
.el-menu-vertical-demo:not(.el-menu--collapse) {
border: none;
}
.submenu {
float: right;
}
.buttonimg {
height: 60px;
background-color: transparent;
border: none;
}
.showimg {
width: 26px;
height: 26px;
position: absolute;
top: 17px;
left: 17px;
}
.showimg:active {
border: none;
}
</style>
注1:使用数据总线,在非父子的组件之间通信,完成左侧菜单折叠
LeftNav.vue
左侧导航
<!-- //这是右侧导航的vue组件 -->
<template>
<el-menu default-active="2" class="el-menu-vertical-demo" background-color="#334157" text-color="#fff"
active-text-color="#ffd04b" :collapse="collapsed">
<!-- collapsed 代表是否这地,这里利用vue的双向数据绑定 -->
<!-- <el-menu default-active="2" :collapse="collapsed" collapse-transition router :default-active="$route.path" unique-opened class="el-menu-vertical-demo" background-color="#334157" text-color="#fff" active-text-color="#ffd04b"> -->
<div class="logobox">
<img class="logoimg" src="../assets/img/logo.png" alt="">
</div>
<el-submenu index="1">
<template slot="title">
<i class="el-icon-location"></i>
<span>导航一</span>
</template>
<el-menu-item-group>
<template slot="title">分组一</template>
<el-menu-item index="1-1">选项1</el-menu-item>
<el-menu-item index="1-2">选项2</el-menu-item>
</el-menu-item-group>
<el-menu-item-group title="分组2">
<el-menu-item index="1-3">选项3</el-menu-item>
</el-menu-item-group>
<el-submenu index="1-4">
<template slot="title">选项4</template>
<el-menu-item index="1-4-1">选项1</el-menu-item>
</el-submenu>
</el-submenu>
<el-menu-item index="2">
<i class="el-icon-menu"></i>
<span slot="title">导航二</span>
</el-menu-item>
<el-menu-item index="3" disabled>
<i class="el-icon-document"></i>
<span slot="title">导航三</span>
</el-menu-item>
<el-menu-item index="4">
<i class="el-icon-setting"></i>
<span slot="title">导航四</span>
</el-menu-item>
</el-menu>
</template>
<script>
export default {
name: 'LeftNav',
data: function() {
return {
collapsed: false
}
},
methods: {
},
//这里利用到了vue生命周期回掉函数
created: function() {
//监听事件 一旦TopNav组件调用 this.$root.Bus.$emit('collapsed-toggle', this.collapsed); 就会触发次方法
this.$root.Bus.$on("collapsed-toggle", (v) => {
//这里利用了vue的动态数据改变的特点使用会将左侧的菜单栏收起会打开
this.collapsed = v;
})
}
}
</script>
<style>
.el-menu-vertical-demo:not(.el-menu--collapse) {
width: 240px;
min-height: 400px;
}
.el-menu-vertical-demo:not(.el-menu--collapse) {
border: none;
text-align: left;
}
.el-menu-item-group__title {
padding: 0px;
}
.el-menu-bg {
background-color: #1f2d3d !important;
}
.el-menu {
border: none;
}
.logobox {
height: 40px;
line-height: 40px;
color: #9d9d9d;
font-size: 20px;
text-align: center;
padding: 20px 0px;
}
.logoimg {
height: 40px;
}
</style>
index.js中配置一下AppMain.vue这个文件的路由
import Vue from 'vue'
import Router from 'vue-router'
import HelloWorld from '@/components/HelloWorld'
//登录注册引入
import Login from '@/views/Login'
import Reg from '@/views/Reg'
//后台首页
import AppMain from '@/views/AppMain'
Vue.use(Router)
export default new Router({
routes: [
{
path: '/',
name: 'Login',
component: Login
},
{
path: '/Login',
name: 'Login',
component: Login
},
{
path: '/Reg',
name: 'Reg',
component: Reg
},
{
path: '/AppMain',
name: 'AppMain',
component: AppMain
}
]
})
在来看看完整的main.js配置
import Vue from 'vue'
// import是ES6标准中的模块化解决方案,require是node中遵循CommonJS规范的模块化解决方案
// 后者支持动态引入,也就是require(${path}/xx.js)
//开发环境下才会引入mockjs
process.env.MOCK && require('@/mock')
//再这里引用后其他页面就可用不用引入了
import ElementUI from 'element-ui' //添加elementUI
//这里导入 element-ui的css文件 避免后期打包样式不同,要放在import App from './App';之前
import 'element-ui/lib/theme-chalk/index.css'
import App from './App'
import router from './router'
// axios/qs在http.js中有所导入,所以最终axios/qs组件是全局的
import axios from '@/api/http'
import VueAxios from 'vue-axios'
//成为全局组件
Vue.use(VueAxios, axios)
//加载elementUI
Vue.use(ElementUI);
Vue.config.productionTip = false
/* eslint-disable no-new */
new Vue({
el: '#app',
router,
components: {
App
},
template: '<App/>',
data: function() {
return {
Bus: new Vue()//总线要通过这里Vue实例来实现相互之间的通信
};
}
})
最后就ojbk了:
vue Bus总线
上面代码用到了总线,这里来介绍总线。相信你看来上面的代码大致也指定这是一个上面东西。就是为了实现组件间的通信。 通过 在main.js中定义 Bus这个vue实例。由于main.js是根组件,子组件都能访问到这个Vue实例,就实现了相互件的通讯。
/* eslint-disable no-new */
new Vue({
el: '#app',
router,
components: {
App
},
template: '<App/>',
data: function() {
return {
//自定义的事件总线对象,用于父子组件的通信
Bus: new Vue()
};
}
})
下面再详细的说明一下这些方法的含义
在A组件触发事件
this.
r
o
o
t
.
B
u
s
.
root.Bus.
root.Bus.emit(“事件名”, 参数1, 参数2, …);
注1:关键点–>this.
r
o
o
t
、
以
前
父
子
组
件
间
触
发
事
件
是
:
t
h
i
s
.
root、以前父子组件间触发事件是:this.
root、以前父子组件间触发事件是:this.emit(“事件名”, 参数1, 参数2, …);
在B组件监听事件
this.
r
o
o
t
.
B
u
s
.
root.Bus.
root.Bus.on(“事件名”, 回调函数);
有时候会发生事件只被emit触发了一次,但是回调函数却被执行了多次的现象。这种现象往往发生在页面跳转退出后重新进入的时候。 产生原因:
this. r o o t . B u s . root.Bus. root.Bus.on实际是向Bus容器中添加一个事件监听器,当页面跳转时,原来的vue组件被注销,但是原来vue组件向Bus容器中添加的事件监听器并不会被移除。
因此,当下次进入这个vue组件对应的页面时,执行到this. r o o t . B u s . root.Bus. root.Bus.on时,又会向Bus容器中添加一个重复的事件监听器,以此类推,
导致Bus容器中有很多个一模一样的事件监听器,从而导致事件只被触发一次,但是回调函数被执行多次的现象。
解决方案:
在vue组件的beforeDetory钩子函数中将本vue组件往Bus容器中添加的事件监听器全部手动移除。
//在vue对象的methods域中定义个函数专门移除事件监听器
offxxxListener: function () {
this.$root.Bus.off("事件名");
this.$root.Bus.off("事件名");
this.$root.Bus.off("事件名");
},
//在vue对象的beforeDestroy钩子中调用以上函数
beforeDestroy() {
this.offxxxListener();
},
注::not(selector) 选择器匹配每个元素是不是指定的元素/选择器。
附录一:
ES6新特性:使用export和import实现模块化
附录二:easy-mock
一个在线模拟后台的数据平台,通过官网注册账户之后,你就可以生成一个在线的API接口,然后通过ajax或者axios就可以访问这个接口了
如果前端开发人员很多,存在跨地区合作,交流困难,后端接口需要频繁修改的话.这种写法并不适合!
这时候推荐使用easy-mock.部署到本地内网后,就可以和其他前端后端小伙伴愉快地 共同维护mock数据和接口.
附录三:
collaps:折叠,collapsed,折叠的过去分词
Toggle:切换开关