源码地址：https://github.com/18291907191/gwc_manage

Vue实战狗尾草博客后台管理系统第一章

这里准备采用的技术栈为：vue全家桶+element-ui

这里因为是后台管理系统，没有做SSR的必要。所以这里就采用前后端分离来昨晚这个项目~

项目搭建

vue init webpack gwc_manage

初始化过程中，会让我们进行一些依赖包，项目配置的基本选择。项目名称，作者信息，描述，是否安装路由，eslint，测试单元，npm/yarn。

这里不选择安装eslint和测试单元。用过的人应该知道非常酸爽。

项目初始化成功后，

npm run dev

可以看到项目成功运行在8080端口。我么就可以打开8080端口查看我们搭建好的项目

上图所述，就是vue初始化后的页面。

安装less并配置全局的变量

npm install less less-loader -s

注：后面的-s表示本地安装-g表示全局安装，不些则表示默认本地安装

因为使用了less后，个人一般喜欢将整个项目的配色进行一个管理。所以需要进行全局的配置。

这里安装完成后，继续安装

npm install sass-resources-loader --save-dev

接下来，我们找到build文件夹下的utils文件

exports.cssLoaders = function (options) {}中加上一下代码：

function lessResourceLoader() {

  var loaders = [

    cssLoader,

    'less-loader',

    {

      loader: 'sass-resources-loader',

      options: {

        resources: [

          path.resolve(__dirname, '../src/assets/styles/common.less'),

        ]

      }

    }

  ];

  if (options.extract) {

    return ExtractTextPlugin.extract({

      use: loaders,

      fallback: 'vue-style-loader'

    })

  } else {

    return ['vue-style-loader'].concat(loaders)

  }

}

注意位置一定要加对，且记得把path.resolve(__dirname,'../src/assets/styles/common.less')路径改成自己对应的文件。然后后面将 return{} 块中的 less: generateLoaders('less') 替换成上面自定义的函数 less: lessResourceLoader()；

修改完配置文件记得重启服务器：npm run dev

给大家上图看一下主要配置：

重启服务后，基本就配置完成。不过我们还是的检测一下。

在common.less中写入：

@bg-blue: #3576e0;

在App.vue中修改

<style lang="less" scoped>

#app {

  font-family: 'Avenir', Helvetica, Arial, sans-serif;

  -webkit-font-smoothing: antialiased;

  -moz-osx-font-smoothing: grayscale;

  text-align: center;

  color: #2c3e50;

  margin-top: 60px;

  background-color: @bg-blue;

}

</style>

然后保存，打开浏览器。就可以看到我们配置好的全局变量被成功引用

背景色变成蓝色。说明在common.less中定义的变量被正常调用。这里全局的less配置也就成功了。

引入全局的基本样式

项目搭建好了，但是可以看到一些基本的样式需要我们进行更改

assets文件夹下styles文件中新建base.less文件。百度搜索reset.css然后复制文中的基本样式，并添加html,body宽高为100%即可。
新建function.less文件css样式工具封装在文中找到适合自己项目的文件复制并粘贴金function.less文件。
新建index.css文件作为出口文件。文件内容如下：

@import './base.less';

@import './function.less';

在main.js文件中引入index.css文件

至此引入的基本的样式文件就算被全局引用了。

至于封装的function样式类，我们只需要在需要的时候，选择性的添加类名即可。

安装element-ui

npm install element-ui -s

安装完成后，在main.js中引入

import ElementUI from 'element-ui'

import 'element-ui/lib/theme-chalk/index.css'

Vue.use(ElementUI);

安装完成后，修改App.vue：

<template>

  <div id="app">

    <img src="./assets/logo.png">

    <el-button type="danger">测试Element</el-button>

    <router-view/>

  </div>

</template>

打开浏览器，我们可以看到button按钮是已经生效了。

这里，element-ui也已经安装成功。

请求方法，拦截器，全局加载框的配置

在src文件夹下新建utils文件夹新建http.js为我们的请求方法的文件

封装前，我们需要借助axios来作为请求的底层,并且需要缓存机制去缓存登录状态

这里借助两个依赖包 axios和vue-cookies

npm install axios vue-cookies -s

请求方法封装。这里封装三个类型的。get请求一个post，json格式的一个post，body格式的一个

import axios from 'axios'

import Vue from 'vue'

// 请求方式的配置

export const postJsonRequest = (url, params) => {

  return axios({

    method: 'post',

    url: url,

    data: params,

    headers: {

      'Content-Type': 'application/json',

    },

  });

}

export const postRequest = (url, params) => {

  return axios({

    method: 'post',

    url: url,

    data: params,

    transformRequest: [function (data) {

      let ret = ''

      for (let it in data) {

        ret += encodeURIComponent(it) + '=' + encodeURIComponent(data[it]) + '&'

      }

      return ret

    }],

    headers: {

      'Content-Type': 'application/x-www-form-urlencoded'

    }

  });

}

export const getRequest = (url, data = {}) => {

  return axios({

    method: 'get',

    params: data,

    url: url,

  });

}

这个就是请求方法的配置

随后我们在utils目录下新建index.js文件作为工具文件夹的出口文件

utils>index.js:

引入封装的http请求并挂在到Vue原型链上供全局使用

import * as http from './http';

const install = (Vue, opts = {}) => {

  if (install.installed) return;

  Vue.prototype.$http = http;

}

export default install

main.js

import Utils from './utils';

Vue.use(Utils);

这里方法请求的封装就算是完成了。

拦截器的配置

拦截器：登录状态的管理，以及每次请求时，我们做的一些处理。对不同code状态做的不同的处理

拦截器分为请求拦截器和响应拦截器。字面意思可理解为：请求时的拦截和响应时的拦截

import axios from 'axios'

import { Message } from 'element-ui'

import router from 'vue-router'

import Vue from 'vue'

import VueCookies from 'vue-cookies'

// 请求拦截

axios.interceptors.request.use(config => {

  if (VueCookies.isKey('isLogin')) {

    const token = getToken(config);

    config.headers['token'] = token;

  }

  return config;

}, err => {

  Message.error({

    message: '请求超时!'

  });

  return Promise.resolve(err);

})

// 响应拦截

axios.interceptors.response.use(res => {

  switch (res.data.code) {

    case 200:

      return res.data.result;

    case 401:

      Message.error({

        message: res.data.message

      });

      router.push('/login');

      VueCookies.remove('userinfo');

      return Promise.reject(res);

    case 201:

      Message.error({

        message: res.data.message

      });

    case 403:

      Message.warning({

        message: res.data.message

      });

      return Promise.reject(res);

    default:

      return Promise.reject(res);

  }

}, err => {

  if (!err.response) {

    return false;

  }

  switch (err.response.status) {

    case 500:

      Message.error({

        message: '服务器出小差了⊙﹏⊙∥'

      });

      break;

    case 504:

      Message.error({

        message: '服务器被吃了⊙﹏⊙∥'

      });

      break;

    case 404:

      Message.error({

        message: '服务器被吃了⊙﹏⊙∥'

      });

      break;

    case 403:

      Message.error({

        message: '权限不足,请联系管理员!'

      });

      break;

    default:

      Message.error({

        message: '网络超时'

      });

  }

  return Promise.reject(err);

})

Vue拦截器的基本配置也就是以上这些了。下来个人想要实现一个loading的局部加载。就要借助计数器了。

为什么说要做一个计数器？

因为在同一个view中可能会有很多个请求，我们总不可能在一个请求完成后就关闭loading的加载吧？这样显然不合适。所以我们需要计时器去将所有的请求记录起来。然后在所有的请求完成后关闭loading。

//请求时loading配置

var loading;

function startLoading() {

  loading = Vue.prototype.$loading({

    lock: true,

    text: "Loading...",

    background: 'rgba(0, 0, 0, 0.5)',

    target: document.querySelector('.loading-area') //设置加载动画区域

  });

}

function endLoading() {

  loading.close();

}

var needLoadingRequestCount = 0;

//开启loading并计数

function showFullScreenLoading() {

  if (needLoadingRequestCount === 0) {

    startLoading();

  }

  needLoadingRequestCount++;

};

//计数器==0关闭loading

function tryHideFullScreenLoading() {

  if (needLoadingRequestCount <= 0) return;

  needLoadingRequestCount--;

  if (needLoadingRequestCount === 0) {

    endLoading();

  }

};

loading的依赖在element安装后是直接挂在到了vue的原型链上。我们不再需要做过多处理。这里计数器完成。下来我们只需要在请求的时候调用，在响应的时候或者请求报错的时候调用关闭的方法即可。

需要注意的是要实现局部的加载，我们就需要在响应实现loading的地方添加类型loading-area才可以!!!

http.js所有代码如下：

/**

 * @description 配置网络请求

 * @author luokaibin chaizhiyang

 */

import axios from 'axios'

import { Message } from 'element-ui'

import router from 'vue-router'

import Vue from 'vue'

import VueCookies from 'vue-cookies'

axios.defaults.timeout = 300000; // 请求超时5fen

//请求时loading配置

var loading;

function startLoading() {

  loading = Vue.prototype.$loading({

    lock: true,

    text: "Loading...",

    background: 'rgba(0, 0, 0, 0.5)',

    target: document.querySelector('.loading-area') //设置加载动画区域

  });

}

function endLoading() {

  loading.close();

}

var needLoadingRequestCount = 0;

function showFullScreenLoading() {

  if (needLoadingRequestCount === 0) {

    startLoading();

  }

  needLoadingRequestCount++;

};

function tryHideFullScreenLoading() {

  if (needLoadingRequestCount <= 0) return;

  needLoadingRequestCount--;

  if (needLoadingRequestCount === 0) {

    endLoading();

  }

};

// 请求拦截

axios.interceptors.request.use(config => {

  showFullScreenLoading();

  if (VueCookies.isKey('userinfo')) {

    const token = getToken(config);

    config.headers['token'] = token;

  }

  return config;

}, err => {

  tryHideFullScreenLoading();

  Message.error({

    message: '请求超时!'

  });

  return Promise.resolve(err);

})

// 响应拦截

axios.interceptors.response.use(res => {

  tryHideFullScreenLoading();

  switch (res.data.code) {

    case 200:

      return res.data.result;

    case 401:

      Message.error({

        message: res.data.message

      });

      router.push('/login');

      // VueCookies.remove('userinfo');

      return Promise.reject(res);

    case 201:

      Message.error({

        message: res.data.message

      });

    case 403:

      Message.warning({

        message: res.data.message

      });

      return Promise.reject(res);

    default:

      return Promise.reject(res);

  }

}, err => {

  tryHideFullScreenLoading();

  if (!err.response) {

    return false;

  }

  switch (err.response.status) {

    case 500:

      Message.error({

        message: '服务器出小差了⊙﹏⊙∥'

      });

      break;

    case 504:

      Message.error({

        message: '服务器被吃了⊙﹏⊙∥'

      });

      break;

    case 404:

      Message.error({

        message: '服务器被吃了⊙﹏⊙∥'

      });

      break;

    case 403:

      Message.error({

        message: '权限不足,请联系管理员!'

      });

      break;

    default:

      Message.error({

        message: '网络超时'

      });

  }

  return Promise.reject(err);

})

// 请求方式的配置

export const postJsonRequest = (url, params) => {

  return axios({

    method: 'post',

    url: url,

    data: params,

    headers: {

      'Content-Type': 'application/json',

    },

  });

}

export const postRequest = (url, params) => {

  return axios({

    method: 'post',

    url: url,

    data: params,

    transformRequest: [function (data) {

      let ret = ''

      for (let it in data) {

        ret += encodeURIComponent(it) + '=' + encodeURIComponent(data[it]) + '&'

      }

      return ret

    }],

    headers: {

      'Content-Type': 'application/x-www-form-urlencoded'

    }

  });

}

export const getRequest = (url, data = {}) => {

  return axios({

    method: 'get',

    params: data,

    url: url,

  });

}

至此整个的全局loading，拦截器，fetch方法的封装就算完成了。

总结

element-ui的使用，我们要多借助官方文档去灵活使用。而不是死记硬背。太多的ui框架，再强的大脑也背不过来，何况，为了自己的头发着想一下啦~
这里并未设置跨域访问。大家可以根据vue的代理。这样也是可以进行跨域访问的。详见我的这篇博文Vue设置代理进行跨域访问，不过这篇文章是针对vue3.0设置，2.0的设置文件，为config下的index.js文件。当然前提是后端接口也进行跨域的设置，否则单纯的前端设置是没有作用的。
局部loading的使用，要求有一个好的布局基础。否则，在后期的使用过程中，会有喝多样式错乱的问题。
请求方式有很多种，还有下载文件的请求配置，delete，post，put等等大家可根据自己需求灵活配置。最终的使用this.$http. get/post/put/...等等就可以进行调用

下一章节：

底层布局（Layout），路由（Router），状态库（vuex），Github仓库关联。

敬请期待~

巴特西

Vue实战狗尾草博客管理系统第一章