详解基于vue-cli3.0如何构建功能完善的前端架子

上一篇文章写了vue和typescript的整合，发现很多小伙伴对vue-cli构建出来的项目很感兴趣，所以今天打算写写怎么在vue-cli3.0的架子上，在进一步完善，整合出具备基础功能的前端架子，主要包括以下几个功能点：

1. webpack 打包扩展
2. css：sass支持、normalize.css
3. rem布局
4. 路由设计:懒加载、前置检查、合法性校验
5. api 设计
6. 请求体设计-防重复提交
7. vuex状态管理

webpack 打包扩展

vue-cli3 最大的特点就是 零配置 ，脚手架把webpack相关的配置都隐藏在@vue\preload-webpack-plugin中，默认的配置可以满足大部分应用场景，优点是我们可以节省很多折腾配置的时间，webpack对于新手来说，还是有点门槛的，这样一来，新人上手可以更关注于vue的编码上。缺点也很明显，对于想自己进行自定义配置的时候，就会稍微麻烦些。

查看当前webpack的详细配置

使用 vue inspect 可以查看到详细的配置列表

扩展webpack配置

当我们想要修改或者扩展webpack配置项时，可以在根目录下新增 vue.config.js 文件，列举个我自己写的简单小栗子

// webpack 扩展
module.exports = {
 baseurl: 'production' === process.env.node_env ?
  '/production-sub-path/' :
  '/',
 chainwebpack: config => {
  config.module
   .rule('images')
   .use('url-loader')
   .tap(options => object.assign(options, { limit: 500 }));
 },
 devserver: {
  open: 'darwin' === process.platform,

  // host: '0.0.0.0',
  port: 8088,
  https: false,
  hotonly: false,

  // proxy: 'https://api.douban.com' // string | object 
  proxy: 'http://localhost:3000' // string | object 
 },
 lintonsave: false
};

官网vue.js 开发的标准工具 的介绍非常详细，而且还有中文版，非常易懂,

sass支持

<style lang="scss"></style>

<style lang="scss">
@import "./assets/style/app";
</style>

在组件中使用自定义的 functions 和 mixin，我暂时没找到全局引用的办法，只能在需要使用的组件文件中手动引用，如下

<style lang="scss">
@import "../assets/style/functions";
@import "../assets/style/mixin";
.rem {
 height: px2rem(187.5px); //自定义的函数
}
.mimi {
 @include clearfix(); //自定义的mixin
}
</style>

为了抹平各个浏览器间的差异，我们需要引入 normalize.css

// app.scss
@import "./node_modules/normalize.css/normalize"; //引用第三方normalize
@import "custom_normalize"; // 自定义的normalize

rem布局

在移动端下使用rem布局是个不错的选择，既然我们使用里的scss，那么可以使用函数来简化我们的重复计算的工作。设计给到的通常是2倍图，宽为750px，那么我们可以将基准设为 document.getelementsbytagname('html')[0].style.fontsize = window.innerwidth / 10 + 'px'; 然后写个转换函数，如下：

// _functions.scss
@function px2rem($px) {
 $rem: 75px;
 @return ($px/$rem) + rem;
}

我们在使用的时候，就可以这么写

.rem {
 height: px2rem(300px); // 2倍图下的宽是300px,
}

转换成css就是

.rem {
 height: 4rem;
}

路由设计

主要包括路由懒加载、路由前置检查、合法性校验逻辑，以下是我写的一个简单路由

import vue from 'vue';
import router from 'vue-router';

// 路由懒加载
const getcomponent = (name: string) => () => import(`./views/${name}.vue`);

vue.use(router);

const router = new router({
 routes: [
  {
   path: '/',
   name: 'home',
   component: getcomponent('home')
  },
  {
   path: '/about',
   name: 'about',
   component: getcomponent('about'),
   meta: {
    auth: true
   }
  },
  {
   path: '*',
   name: 'not_fount',
   component: getcomponent('notfount')
  }
 ]
});

/**
 * 路由前置检查
 */
router.beforeeach((to, from, next) => {
 // 合法性校验
 if (to.meta.auth) {
  console.log('into auth');
  next();
 }
 next();
});
export default router;

api 设计

新建 service 文件夹用于存放api脚本，根据业务模块来划分文件，如用户相关的api一个文件、购买相关的一个文件， api.ts 是各模块api的集合，如下

// service/api.ts
export { userapi } from './user';
export { buyapi } from './buy';

// service/user.ts
export const userapi = {
 /**
  * 获取用户数据
  */
 userinfo: '/node_api/read/userinfo'
};
// service/buy.ts
export const buyapi = {
 /**
  * 购买
  */
 shoping: '/node_api/shop/buy'
};

这么划分，是为了项目结构和业务结构都足够清晰，同时可以避免单文件过长的问题。

http请求二次封装

发送http我使用的是非常流行的 axios ，我在其基础上，稍微进行简单的封装，然后暴露 request 对象供调用。二次封装主要是为了解决以下几个问题

1. 简化参数，把一些常用参数都赋默认值，简化外部的使用，使得更加通用和利于排查问题。
2. 返回报文统一处理，我们通常需要对些高频的场景做相同的处理，如错误码、未登录等场景，可以在它提供的返回响应拦截器中，统一处理。
3. 防止重复提交，因为网络、后端处理的因素，有时接口响应会较慢，那么用户可能会在非常短的时间内，反复点击按钮，在第一次请求未返回的情况下，会再次发起新的请求，那么我们可以在axios提供的前置拦截器中搞点事情。关于防止重复请求这东东，我在以前的一篇文章有写过， 感兴趣的小伙伴可以看看。

根据以上几点，下面是我封装的request文件，思路都比较简单，就不多说啦

import axios from 'axios';
import qs from 'qs';

const axios = axios.create({
 baseurl: '/',
 timeout: 10000,
 responsetype: 'json',
 withcredentials: true,
 headers: {
  'content-type': 'application/x-www-form-urlencoded;charset=utf-8'
 }
});
const canceltoken = axios.canceltoken;
const requestmap = new map();

// 请求前置拦截器
axios.interceptors.request.use(
 config => {

  // 防重复提交
  const keystring = qs.stringify(object.assign({}, { url: config.url, method: config.method }, config.data));
  if (requestmap.get(keystring)) {
   // 取消当前请求
   config.canceltoken = new canceltoken((cancel) => {
    cancel('please slow down a little');
   });
  }
  requestmap.set(keystring, true);
  object.assign(config, { _keystring: keystring });

  if (config.method === 'post' || config.method === 'put' || config.method === 'delete') {
   // 序列化
   config.data = qs.stringify(config.data);
  }

  return config;
 },
 error => {
  return promise.reject(error);
 }
);

// 返回响应拦截器
axios.interceptors.response.use(
 res => {
  // 重置requestmap
  const config: any = res.config;
  requestmap.set(config._keystring, false);

  if (res.status === 200) {
   return res.data;
  }
  // todo 弹窗提示等
  console.log(`request error：${res}`);
 },
 error => {
  return {
   code: -1
  };
 }
);

/**
 * @description
 * 请求
 * @param url
 * @param data
 * @param method
 */
const request = (url: string, data = {}, method = 'post') => {
 return axios({
  method,
  url,
  data,
  params: method.touppercase() === 'get' && data
 });

};

export { request };

vuex状态管理

这里我根据业务模块来划分文件结构，如下图

分为首页模块和用户模块，每个模块都有自己独立的 state mutations 等，在 store.ts 中，引入各模块的文件，如下

import vue from 'vue';
import vuex from 'vuex';
import index from './indexmodule/index';
import user from './usermodule/user';

vue.use(vuex);

export default new vuex.store({
 modules: {
  user,
  index
 }
});

大家注意到这里有个 store_types.ts 文件，这个文件主要是为了搭配ts使用的，文件内容如下

export enum usertype {
 /**
  * 模块名称
  */
 'module_name' = 'user',
 /**
  * 增加次数
  */
 'add_count' = 'addcount',
 /**
  * 计算属性-获取十倍的值
  */
 'get_tem_count' = 'gettencount'
}

在看下组件中的使用方式：

<script lang="ts">
import { usertype } from '@/store/store_types';
import { component, prop, vue, watch,emit } from 'vue-property-decorator';
import {
 action,
 getter,
 mutation,
 namespace,
 state
} from 'vuex-class';

@component
export default class test extends vue {

 @state(state => state[usertype.module_name].count) public fff!: number;

 @getter(`${usertype.module_name}/${usertype.get_tem_count}`) public tencount!: number;

 @mutation(`${usertype.module_name}/${usertype.add_count}`) public addcount!: any;

}
</script>

虽然这么写的确有点绕，但有个好处，我们可以通过注释清晰知道方法和属性的说明

小结

以上是我根据自己工作中常见的场景来设计的，希望能对小伙伴能有帮助，其中设计不当的地方，欢迎小伙伴们在留言区一起探讨哈~也希望大家多多支持。