vue 实现 excel导出导入功能

第一步下包
excel导入导出功能需要我们下载哪些包？
在vue-element-admin中有着详细的文档查看：

Excel 导出

Excel 的导入导出都是依赖于js-xlsx来实现的。

在 js-xlsx的基础上又封装了Export2Excel.js来方便导出数据。

#使用

由于 Export2Excel不仅依赖js-xlsx还依赖file-saver和script-loader。

所以我们需要下载三个包，和一个js文件 Export2Excel

npm install xlsx file-saver -S
npm install script-loader -S -D

第二步：各种功能的实现

1.1：基本表头导出功能

1.2：复杂表头导出功能

1.3：excel表格导入功能

1.1.1：excel导出逻辑

逆向思维思考：

1-最终要拿到的是一个充满数据的文件

2-如何导出一个文件：用到excel.export_json_to_excel

3-export_json_to_excel方法需要那些参数：

    multiHeader：// 多级表头
 
​    header:, //表头 必填
 
​     data: //具体数据 必填
 
​     filename: //表格名字
 
​     merges: //合并单元格
 
​     autoWidth: true, // 是否自适应宽度
 
​     bookType: 'xlsx', //导出格式

4-了解参数的数据类型，接下来将数据转成能够导出的数据类型，也就是处理数据

5-先有数据才能处理数据，所以应该是要拿数据

到现在导出的逻辑已经清楚,那么开始正向梳理一下逻辑

1-发请求拿数据

2-定义方法处理数据

3-调用export_json_to_excel方法导出表格

4-查看导出的表格是否满意

接下来我将用后台人资项目来演示基本的数据导出excel表格

// 1- 获取数据并且处理完的数据
    async onExportFn() {
      // 1-请求获取所有的数据
      // {data} 是对请求拿到的数据进行结构
      const { data } = await FindStaffList({ page: 1, size: this.total })
      // 1-1 此时list里面保存的是所有的员工列表信息
      const list = data.rows
      console.log(list)
      // 2-2 对数据进行处理 此时FilnalData 拿到的就我们要的数据格式  
      // 此处我封装成了一个函数 onSortList 并且将拿到的list数据传入该方法
      return this.onSortList(list)
    },

注意一点在这里需要data的数据类型是一个二维数组[[],[],[],....[]] 在vue-element-admin 中有详细的文档，搜索“导出” 或者搜索xlsx即可

// 2-2 对数据进行处理  在这里只是讲获取数据的方法，这是最简单的一种，也可以用map对数据进行处理，方法不一，只列出最简单易理解的
 
onSortList(list) {
      // 2-1 先定义排列顺序  这里通常有一个学术名叫做对照表
      const sortOrder = [
        'username',
        'mobile',
        'timeOfEntry',
        'formOfEmployment',
        'correctionTime',
        'workNumber',
        'departmentName',
      ]
      // FilnalData 用来存放最后的数据
      const FilnalData = []
      list.forEach((item) => {
        const arr = []
        sortOrder.forEach((obj) => {
          if (obj === 'formOfEmployment') {
            arr.push(item[obj] === 1 ? '正式' : '非正式')
          } else {
            arr.push(item[obj])
          }
        })
        FilnalData.push(arr)
      })
      return FilnalData
    },

// 3- 此时数据已经处理完毕，那么就可以调用export_json_to_excel方法来进行导出表格
async onOrdinaryExport() {
      this.ExportLoading = true
      // onExportFn() 这里是一个primise异步方法，所以要用await
      const FilnalData = await this.onExportFn()
      //  import('@/vendor/Export2Excel') 懒加载  导入后，拿到excel对象 的对象中有export_json_to_excel 方法
      import('@/vendor/Export2Excel').then((excel) => {
        excel.export_json_to_excel({
          header: [
        '姓名',
        '手机号',
        '入职日期',
        '聘用形式',
        '转正日期',
        '工号',
        '部门',
      ], //表头 必填
          data: FilnalData, //具体数据 必填
          filename: '员工信息表格',
          autoWidth: true,
          bookType: 'xlsx',
        })
      })
      this.ExportLoading = false
    },

如上操作，即可完美导出一份普通的带有表头的表格

1.2.1复杂表头导出功能
复杂表头和基本表头的导出，思考的逻辑是一样的，所以不再赘述

复杂表头的导出，相比基本表头导出，只有在export_json_to_excel中传递的参数多了两个 一个是 multiHeader（多级表头），一个是merges（合并）

通过分析export_json_to_excel.js文件的源代码，我们可以分析出，multiHeader是二维数组，merges是一维数组，数组中的内容是字符串，而且是带有：的字符串

所以，根据要求，我们可以自由合并单元格
 

filename = filename || 'excel-list'
  data = [...data]
  data.unshift(header)
 
  for (let i = multiHeader.length - 1; i > -1; i--) {
    data.unshift(multiHeader[i])
  }

部分源码如图。

data中的数据，首先会先把传过来的数据data解构后放入data中，然后对多级表头进行循环，循环结束，将每个数据push到data中，因为data中的数据是个数组中放的每一个元素是数组

所以multiHeader[i]是数组，所以multiHeader 是二维数组

复杂表头代码如下，与一般表头只有在导出的时候有差别
 

async onComplexExport() {
      this.ComplexExportLoading = true
      // 调用onExportFn方法获取处理完成后的数据  该方法，上面有
      const FilnalData = await this.onExportFn()
      
      import('@/vendor/Export2Excel').then((excel) => {
        excel.export_json_to_excel({
          multiHeader: [['姓名', '主要信息', '', '', '', '', '部门']],
          header: [
        'username',
        'mobile',
        'timeOfEntry',
        'formOfEmployment',
        'correctionTime',
        'workNumber',
        'departmentName',
      ], //表头 必填
          data: FilnalData, //具体数据 必填
          filename: '复杂表头的员工信息表格',
          // 要合并的单元格
          merges: ['A1:A2', 'B1:F1', 'G1:G2'],
          autoWidth: true,
          bookType: 'xlsx',
        })
      })
      this.ComplexExportLoading = false
    },

1.3.1：excel表格导入功能

Excel 导入

封装了UploadExcelExcel 导入组件，支持点击和拖拽上传，同样它也是依赖js-xlsx的。

所以要实现导入功能

需要下载三个包，和一个vueUploadExcel组件

npm install xlsx file-saver -S
npm install script-loader -S -D

UploadExcel它提供了两个回调函数：beforeUpload：你可以在上传之前做一些自己的特殊判断，如判断文件的大小是否大于 1 兆？若大于 1 兆则停止解析并提示错误信息。

• onSuccess 解析成功时候会触发的回调函数，它会返回表格的表头和内容。

  handleSuccess({ results, header }) {
        this.tableData = results
        this.tableHeader = header
      }

• 导入的功能，总体来说，要比导出简单一些，更加容易理解一下

总结思路

反向思考

1-最终要实现的效果，给当前页面添加几行数据

2-要实现给当前页面添加几行数据，并且是我们看的到数据，因为只有数据才能改变视图，所以我们一定要发请求，才能够将数据添加上

3--发请求，必然要牵扯到请求的参数，那么就要看参数是什么格式的

4-有了参数的格式，那么我们就需要将一个方法，用来将我们得到的数据，转变成参数需要的数据类型

5-要转变，首先要先拿到表格里面的数据，所以这就需要用到我们的UploadExcel组件给我们提供的一个方法onSuccess

到现在导出的逻辑已经清楚,那么开始正向梳理一下逻辑‘

1-下载组件，在页面中导入，使用onSuccess方法，拿到表格的数据 tableData

2-定义一个方法，对拿到的数据进行处理，将数据处理成我们发请求需要的数据

3-定义接口，导入接口，发请求

4-调用接口，重新获取数据，渲染视图

逻辑清楚，代码开始

以下是我对UploadExcel组件的一些源码的分析与整理，只有简单的标注和样式的修改

• 接受onSuccess回调函数中，对数据进行处理

 

onSuccess(excelData) {
      // console.log(excelData)  在这里打印的是除了表头之外的数据 也就是我们需要的数据
      // 定义一个数据对照表
      const contrastObj = {
        入职日期: 'timeOfEntry',
        姓名: 'username',
        手机号: 'mobile',
        工号: 'workNumber',
        转正日期: 'correctionTime',
      }
      // 定义一个空数组，用来保存最后需要发请求的数据
      const excelList = []
      // 对拿到的数据进行遍历
      excelData.results.forEach((item) => {
        const obj = {}
        for (const key in item) {
          if (key === '转正日期' || key === '入职日期') {
            obj[contrastObj[key]] = formatDate(item[key], '-')
          } else {
            obj[contrastObj[key]] = item[key]
          }
        }
        excelList.push(obj)
      })
      // console.log(excelList)
      // 在这里已经完成数据的整理，调接口，发送请求
    },

至此一个完整体系 的 基于vue的表格的导入导出总结完毕，学习愉快