Vue + iView + vuex + vee-validate 完整项目总结

 

   

  部门最近的一个新项目启动,很幸运由我来主导整个前端部分的技术选型和整体架构,项目工作量很大,但是却没有足够的人手,只有三个连CSS都不太会的实习生跟着我一起做,压力山大。两个月以来,虽然遇见了很多问题,但是最终顺利的解决了,项目基本完成,果断写一篇总结,毕竟是第一个真正意义上全权自己负责的大项目 。

  一、技术选型。

  如果没有接触过新的知识,我可能会像之前的部门的所有项目一样,按部就班的使用Jquery + bootstrap + sea.js/require.js 进行开发,但是我说了NO。

  首先,这次项目初步估计有近百个功能点和几十个页面,如果仍用jquery的方法,光是臃肿的dom操作代码就把人写的筋疲力尽了,而且我自己本人也是在是厌倦了重复而乏味DOM操作。所以我选择了Vue, 至于为什么不是react和anglar, 相对于他们Vue我觉得对于新手来说是很容易上手的,相对于react一些相关的技术栈,Vue对于实习生更容易掌握。使用Vue我只需要把项目共用的模块封装成共用组件,让他们去调用就可以了,这一点保证了他们很少去写CSS样式,也为项目快速的开发完成起到了一定的决定因素。

  最终使用的技术如下:

  基础JS框架: Vue, 基础样式和组件框架: iView ,国际化插件: vue-i18n,表单验证插件:vee-validate

  项目打包工具:webpack + babel

  代码规范性检查: eslint

  二、项目过程中遇见的问题。

  这部分其实是我写这篇博客的主要目的,好多问题,毕竟总结更多的是去记录过去遇见的问题和走过的弯路。

  1、旧的JS代码的兼容。

  由于项目中有一部分的代码是之前的项目组使用的seajs封装的模块,而且这部分代码内部的逻辑比较复杂,重写基本是不可能的,没时间何精力去研究,只有通过引入到我们的webpak工程中,如何把这部分代码挪过来并且很少改动就成了一个大问题。很幸运,webpack直接支持AMD或CMD的代码,我用的vue-cli初始化的项目,所以更改了一些webpack.base.config里的一些配置,但是忍让需要修改一些配置让原来js里的require能够找到原来的模块并执行。

  新建了一个oldModuleConfig.js,

const path = require('path')

function resolve (dir) {
  return path.join(__dirname, '..', dir)
}

const oldModuleConfig = {
  'vue$': 'vue/dist/vue.esm.js',
  '@': resolve('src'),
   /* Switch EWeb */
  'oldModule1': resolve('src/oldModule1'),
  'oldModule2': resolve('src/oldModule2'),
  'oldModule3': resolve('src/oldModule3'),
  'oldModule4': resolve('src/oldModule4'),
}

module.exports = oldModuleConfig 

  然后修改了webpack.base.config.js

resolve: {
    extensions: ['.js', '.vue', '.json', '.less'],
  /**  alias: {
      'vue$': 'vue/dist/vue.esm.js',
      '@': resolve('src')
    } **/
    // 将原来的这部分改成这样
    alias: oldModuleConfig
  }

  

 这样原来的module1里面如果写了require就可以直接使用了

var module2 = require('module2') //这行代码如果没有配置直接引入就找不到module2这个模块,而配置alias之后就可以运行了

  这是本人自己想到的略low的方法,如果有高人指出可以在webpack里引入旧的seajs/requirejs代码其他方法,欢迎指出。

  2、原有代码无法通过eslint语法检查

  原来的代码虽然引进来了,但是却无法通过eslint的检查,这个问题我是直接选择忽视原有文件的检查,如果你是用了vue-cli构建的项目,可以修改.eslintignore

build/*.js
config/*.js
src/oldCodeFolder //旧代码的文件夹

  3、Vue-router 页面刷新

  如果用过vue-router的应该知道,如果点击的链接就是现在的页面,那么当前页面组件是不会刷新的,实际过程中可能希望再次点击页面是刷新一下。解决办法是使用一个中转页面bus,所有的页面跳转到这个bus.vue,然后由这个页面再调回原来的页面,这样就达到了刷新的效果。

  

<!-- 
  这是一个中转的页面,本身不具有任何内容,为什么要设置这个中转页面呢?
  因为vue-router点击当前页面的链接时并不会刷新组件,为了保持再次点击刷新,
  通过设置这个bus中转页面即可实现
 -->
<template>
  <div>
  </div>
</template>
<script>
export default {
  data () {
    return {}
  },
  methods: {
    jumpToPage () {
      let path = this.$route.params.path
      if (path) {
        this.$router.replace(path)
      }
    }
  },
  mounted: function () {
    this.jumpToPage()
  }
}
</script>

  然后router-view里传入下一个即将跳转的页面路径即可

  <router-link :to="{ name: 'bus', params: { path: nextPath }}":key="link.en"> {{ link.en }} </router-link>

  

  4、iView封装带分页的表格组件

  iView提供了Table和Page两个组件,但是很蛋疼,没有提供带分页的表格组件,所以需要自己进行组合实现。这里提供示例代码,

  

<template>
    <div class="clear">
      <Table :columns='columns' :data='showData' :ref="refLabel" :loading="loading" stripe :no-data-text="'<span class=\'no-data-text \' > <i class=\'icon-no-data\'></i> ' + $t('message.nodata')+ '</span>'"></Table>
      <Page :total='dataCount' :page-size='pageSize' :show-total='isShowTotal' :current.sync="current" class='paging' @on-change='changepage'></Page>
    </div>
</template>
<style scoped>
  .paging{
      float:right;
      margin-top:20px;
  }
</style>
<script>
export default {
  data () {
    return {
      ajaxHistoryData: [],
      // 初始化信息总条数
      dataCount: 0,
      // 每页显示多少条
      showData: [],
      current: 1
    }
  },
  props: {
    pageSize: {
      type: Number,
      default: 10
    },
    columns: {
      type: Array
    },
    isShowTotal: {
      type: Boolean,
      default: true
    },
    tableData: {
      type: Array
    },
    refLabel: {
      type: String
    },
    loading: {
      type: Boolean,
      default: false
    }
  },
  methods: {
    // 获取历史记录信息
    handleShowData () {
      if (this.tableData && this.tableData.length) {
        // 保存取到的所有数据
        this.dataCount = this.tableData.length
        // 初始化显示,小于每页显示条数,全显,大于每页显示条数,取前每页条数显示
        if (this.tableData.length < this.pageSize) {
          this.showData = this.tableData
        } else {
          this.showData = this.tableData.slice(0, this.pageSize)
        }
      } else {
        this.showData = []
        this.dataCount = 0
      }
      this.current = 1
    },
    currentChange (value) {
    },
    changepage (index) {
      var _start = (index - 1) * this.pageSize
      var _end = index * this.pageSize
      this.showData = this.tableData.slice(_start, _end)
    }
  },
  created () {
    this.handleShowData()
  },
  watch: {
    tableData (oldVal, newVal) {
      this.handleShowData()
    // 表格刷新了,当前页标识需要回到第一页的位置 this.current = 1 } } } </script>

  这里没有写异步获取数据的方法,所以具体使用时需要解渴自己的业务逻辑进行修改。

   5、webpack打包体积过大,减少打包体积

  说出来你们可能不信,我们的代码最终放在的服务器智能放下60M左右的文件,我也是很无奈,所以减少webpack打包体积就成了一个必须的问题。解决方法如下:

    a、首先最直观的,将生产环境的sourceMap设为false ,这里设置完之后,打包后的文件就没有了.map文件,这一步基本减少了一大半的代码体积。

    b、使用webpack-bundle-analyzer 优化你的代码

     如果vue-cli构建的项目,只需要在package.json的scripts里加入:

"analyz": "set NODE_ENV=production && set npm_config_report=true && npm run build"

         然后运行npm run analyz, 打包成功后浏览器会自动打开类似下面的页面,找出其中共用写入Vendors, 然后使用webpack.optimize.CommonsChunkPlugin 进行优化

  

  c、如果你们有CDN的话,尽量把基础代码如: vue , vue-router 放在CDN上面

  d、tree shaking 去除无用的代码

  6、其他

  其实还有许多大大小小的问题,比如Vue的路由拦截,webpack多页面,DDL优化打包速度,覆盖iVIew组件,nginx代理,组件scoped样式覆盖不了iView默认样式等等许多,每一个解决完了都有满满的成就感。

  三、项目构建问题回顾

  1、代码初期没有架构合理,导致后期存在一些维护上的问题。

  比如,代码引入了SASS,开始没有设置一个主题的公共文件,导致后面设计变动整体主题跟着发生了一些改变,虽然iView支持更改主题,但是自己写的一些组件由于没有共用的主题文件,导致后期修改比较麻烦。

  2、代码没有review

  虽然代码整体风格使用了eslint去规范了,但是其实真正开发的时候发现三个兄弟的代码很不规范,毕竟工作经验不足,包括变量的大小写,css类命名,甚至在页面里使用了Jquery等问题,一开始没有review, 后期仔细阅读他们的代码的时候才发现这些问题,然后才进行修改。其实这些问题在项目开始我就应该说明的。

  3、其他

  后续补充。。。

  四、项目收获

  整个项目在代码架构上还是获得了其他同事的认可,至少推动了部门前端向前走了一步,我算是部门第一个吃螃蟹的人,敢于把新技术果断使用到新的项目里,第一次将webpack + vue的技术栈整体运用了一遍,虽然不能说精通,但是应该也是熟练掌握了,总觉得自己平日所学没有白费,实践应用了一遍满满的收获。

  2018 继续前行。

   喜欢的话可以点个推荐或者关注哦!

 

 

  注:本文出自博客园 https://home.cnblogs.com/u/mdengcc/ ,转载请注明出处。

posted @ 2018-01-16 10:12  断劫断念  阅读(7801)  评论(16编辑  收藏  举报