SPA项目开发之首页导航+左侧菜单

主要技术点
1、mock.js模拟响应ajax请求
2、通过js代码完成路由的跳转
3、后台主界面的搭建
4、退出功能
5、左侧树收缩功能（vue总线的概念）

Mock.js

技术背景

前后端分离开发开发过程当中，经常会遇到以下几个尴尬的场景：

1. 老大，接口文档还没输出，我的好多活干不下去啊！
2. 后端小哥，接口写好了没，我要测试啊！

前后端分离之后，前端迫切需要一种机制，不再需要依赖后端接口开发，而今天的主角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.$root.Bus.$emit(“事件名”, 参数1, 参数2, …);
注1：关键点–>this.$root、以前父子组件间触发事件是：this.$emit(“事件名”, 参数1, 参数2, …);

在B组件监听事件
this.$root.Bus.$on(“事件名”, 回调函数);

有时候会发生事件只被emit触发了一次，但是回调函数却被执行了多次的现象。这种现象往往发生在页面跳转退出后重新进入的时候。 产生原因：

this.$root.Bus.$on实际是向Bus容器中添加一个事件监听器，当页面跳转时，原来的vue组件被注销，但是原来vue组件向Bus容器中添加的事件监听器并不会被移除。

因此，当下次进入这个vue组件对应的页面时，执行到this.$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：切换开关