一. 安装(固定)

  1. npm install xlsx -S

二. 拷贝组件(固定)

这个组件名字就是 UploadExcel 这个组件将作为儿子 被别的父亲用

1. 复制到我们自己项目的 src/components/UploadExcel

  1. <template>
  2. <div>
  3. <input ref="excel-upload-input" class="excel-upload-input" type="file" accept=".xlsx, .xls" @change="handleClick">
  4. <div class="drop" @drop="handleDrop" @dragover="handleDragover" @dragenter="handleDragover">
  5. 拖入excel文件 or
  6. <el-button :loading="loading" style="margin-left:16px;" size="mini" type="primary" @click="handleUpload">
  7. 浏览
  8. </el-button>
  9. </div>
  10. </div>
  11. </template>
  12. <script>
  13. import XLSX from 'xlsx'
  14. export default {
  15. name: 'UploadExcel',
  16. props: {
  17. beforeUpload: Function, // eslint-disable-line
  18. onSuccess: Function// eslint-disable-line
  19. },
  20. data() {
  21. return {
  22. loading: false,
  23. excelData: {
  24. header: null,
  25. results: null
  26. }
  27. }
  28. },
  29. methods: {
  30. generateData({ header, results }) {
  31. this.excelData.header = header
  32. this.excelData.results = results
  33. this.onSuccess && this.onSuccess(this.excelData)
  34. },
  35. handleDrop(e) {
  36. e.stopPropagation()
  37. e.preventDefault()
  38. if (this.loading) return
  39. const files = e.dataTransfer.files
  40. if (files.length !== 1) {
  41. this.$message.error('Only support uploading one file!')
  42. return
  43. }
  44. const rawFile = files[0] // only use files[0]
  45. if (!this.isExcel(rawFile)) {
  46. this.$message.error('Only supports upload .xlsx, .xls, .csv suffix files')
  47. return false
  48. }
  49. this.upload(rawFile)
  50. e.stopPropagation()
  51. e.preventDefault()
  52. },
  53. handleDragover(e) {
  54. e.stopPropagation()
  55. e.preventDefault()
  56. e.dataTransfer.dropEffect = 'copy'
  57. },
  58. handleUpload() {
  59. this.$refs['excel-upload-input'].click()
  60. },
  61. handleClick(e) {
  62. const files = e.target.files
  63. const rawFile = files[0] // only use files[0]
  64. if (!rawFile) return
  65. this.upload(rawFile)
  66. },
  67. upload(rawFile) {
  68. this.$refs['excel-upload-input'].value = null // fix can't select the same excel
  69. if (!this.beforeUpload) {
  70. this.readerData(rawFile)
  71. return
  72. }
  73. const before = this.beforeUpload(rawFile)
  74. if (before) {
  75. this.readerData(rawFile)
  76. }
  77. },
  78. readerData(rawFile) {
  79. this.loading = true
  80. return new Promise((resolve, reject) => {
  81. const reader = new FileReader()
  82. reader.onload = e => {
  83. const data = e.target.result
  84. const workbook = XLSX.read(data, { type: 'array' })
  85. const firstSheetName = workbook.SheetNames[0]
  86. const worksheet = workbook.Sheets[firstSheetName]
  87. const header = this.getHeaderRow(worksheet)
  88. const results = XLSX.utils.sheet_to_json(worksheet)
  89. this.generateData({ header, results })
  90. this.loading = false
  91. resolve()
  92. }
  93. reader.readAsArrayBuffer(rawFile)
  94. })
  95. },
  96. getHeaderRow(sheet) {
  97. const headers = []
  98. const range = XLSX.utils.decode_range(sheet['!ref'])
  99. let C
  100. const R = range.s.r
  101. /* start in the first row */
  102. for (C = range.s.c; C <= range.e.c; ++C) { /* walk every column in the range */
  103. const cell = sheet[XLSX.utils.encode_cell({ c: C, r: R })]
  104. /* find the cell in the first row */
  105. let hdr = 'UNKNOWN ' + C // <-- replace with your desired default
  106. if (cell && cell.t) hdr = XLSX.utils.format_cell(cell)
  107. headers.push(hdr)
  108. }
  109. return headers
  110. },
  111. isExcel(file) {
  112. return /\.(xlsx|xls|csv)$/.test(file.name)
  113. }
  114. }
  115. }
  116. </script>
  117. <style scoped>
  118. .excel-upload-input{
  119. display: none;
  120. z-index: -9999;
  121. }
  122. .drop{
  123. border: 2px dashed #bbb;
  124. width: 600px;
  125. height: 160px;
  126. line-height: 160px;
  127. margin: 0 auto;
  128. font-size: 24px;
  129. border-radius: 5px;
  130. text-align: center;
  131. color: #bbb;
  132. position: relative;
  133. }
  134. </style>

2. 注册成全局组件

此处 省略….. 看你是哪种全局,是在main.js里面还是Vue.use()下面

三: 准备页面(固定)

1 . 建立公共的导入页面:

  1. 这个组件就取个名字叫做 **import 组件吧, 创建在 src/views/import/index.vue 固定写法**<br />** 哪个页面要用到导入excel功能,哪个页面就调用这个子组件import**
  1. <template>
  2. <UploadExcel :on-success="handleSuccess" /> // 调用UploadExcel组件
  3. </template>
  4. <script>
  5. export default {
  6. name: 'Import',
  7. methods: {
  8. handleSuccess({ header, results }) {
  9. console.log(header, results)
  10. }
  11. }
  12. }
  13. </script>

说明: :on-success=”handleSuccess” 表示成功之后的回调


2. 配置路由:

根据场景来看: 是定义为静态路由(不需要权限控制)或者 是动态路由

  1. {
  2. path: '/import',
  3. component: Layout,
  4. hidden: true, // 不显示到左侧菜单
  5. children: [{
  6. path: '',
  7. component: () => import('@/views/import')
  8. }]
  9. }

3. 添加点击事件: (这一步不是固定的,具体就看你怎么使用这个

import组件了)

点击导入 , 路由跳转到import组件(这个组件现在充当父组件,就是用上面这个儿子组件的父组件)

  1. ![image.png](https://cdn.nlark.com/yuque/0/2021/png/21762447/1625161741747-c7bf5c4d-41b1-4cf1-887c-7f3427272bcf.png#clientId=u1ad8354c-ce63-4&from=paste&height=41&id=BObXx&margin=%5Bobject%20Object%5D&name=image.png&originHeight=41&originWidth=437&originalType=binary&ratio=1&size=3708&status=done&style=none&taskId=u9b60dd69-0431-42df-922e-e9e60db82f5&width=437)

效果图:

  1. ![image.png](https://cdn.nlark.com/yuque/0/2021/png/21762447/1625162628590-90b7986b-fad2-4a4a-85ab-2daad1c34145.png#clientId=u1ad8354c-ce63-4&from=paste&height=151&id=u89a4ebeb&margin=%5Bobject%20Object%5D&name=image.png&originHeight=151&originWidth=516&originalType=binary&ratio=1&size=7551&status=done&style=none&taskId=ueb4c4ae4-ee92-4171-b3dd-fa52fd94afc&width=516)

里面的功能就是我上面拷贝的那个组件里面的

小结:

excel导入插件本质:

把excel经过分析转换成js能够识别的常规数据,拿到数据我们可以进

行任何操作

四: 数据处理 (固定,但是要结合实际情况来处理)

(去看看我写的另外一个excel导出,里面也有处理数据)

1. 说明:

* 数据格式转换:将excel解析好的数据经过处理后,转成可以传给接口调用的数据

  1. * 调用接口进行excel上传的**重点其实是数据的处理**,我们需要按照接口的要求,把excel表格中<br /> 经过插件处理好的数据处理成后端接口要求的格式<br />![image.png](https://cdn.nlark.com/yuque/0/2021/png/21762447/1625163054958-a6127b66-cbe1-49b5-99c5-2bccbc04fe43.png#clientId=u1ad8354c-ce63-4&from=paste&height=277&id=u8ad208b3&margin=%5Bobject%20Object%5D&name=image.png&originHeight=277&originWidth=819&originalType=binary&ratio=1&size=47391&status=done&style=none&taskId=ub98cdc6b-0dcc-4d2a-894b-5e744e1bb09&width=819)

2. 演示例子代码:

数据处理以及时间处理:

transExcel()是做数据转换的(自己取得名字)

转换的目标:

[{‘姓名’:’小张’, ‘手机号’:’13888888’, ….}]

转成

[{‘username’:’小张’,’mobile’:’13888888’}]

  1. transExcel(results) {
  2. const mapInfo = {
  3. '入职日期': 'timeOfEntry',
  4. '手机号': 'mobile',
  5. '姓名': 'username',
  6. '转正日期': 'correctionTime',
  7. '工号': 'workNumber',
  8. '部门': 'departmentName',
  9. '聘用形式': 'formOfEmployment'
  10. }
  11. const arr = results.map(obj => {
  12. // 把一个对象数组中的每个对象的属性名从中文改成英文
  13. // 思路: 对于原数组的每个对象来说:
  14. // 1. 找出所有的中文key
  15. // 2. 得到对应该的英文的key
  16. // 3. 拼装一个新对象: 英文的key:值
  17. const _obj = {} // 定义一个新的对象 最后装入新的对象的
  18. // 1. 找出所有的中文key
  19. const zhKeys = Object.keys(obj)
  20. // zhKeys : ['姓名','手机号',.....]
  21. zhKeys.forEach(zhKey => {
  22. // 2. 得到对应该的英文的key
  23. const enKey = mapInfo[zhKey]
  24. console.log(enKey) // 已经拿到所有英文的key了
  25. // 日期处理。从excel中读入的时间是一个number值,而后端需要的是标准日期。
  26. if (enKey === 'timeOfEntry' || enKey === 'correctionTime') {
  27. // 后端需要的日期格式是标准时间
  28. // 这里的formatExcelDate方法就是封装的时间格式化的方法
  29. _obj[enKey] = new Date(formatExcelDate(obj[zhKey]))
  30. } else {
  31. // 3.拼装一个新对象: 英文的key:值
  32. _obj[enKey] = obj[zhKey]
  33. }
  34. })
  35. return _obj
  36. })
  37. return arr
  38. }

为什么要对时间进行处理? 是因为后端需要的是一个标准日期。
image.png

3. 把excel文件中的日期格式的内容转回成标准的时间

  1. // 把excel文件中的日期格式的内容转回成标准时间
  2. // https://blog.csdn.net/qq_15054679/article/details/107712966
  3. export function formatExcelDate(numb, format = '/') {
  4. const time = new Date((numb - 25567) * 24 * 3600000 - 5 * 60 * 1000 - 43 * 1000 - 24 * 3600000 - 8 * 3600000)
  5. time.setYear(time.getFullYear())
  6. const year = time.getFullYear() + ''
  7. const month = time.getMonth() + 1 + ''
  8. const date = time.getDate() + ''
  9. if (format && format.length === 1) {
  10. return year + format + month + format + date
  11. }
  12. return year + (month < 10 ? '0' + month : month) + (date < 10 ? '0' + date : date)
  13. }

五: 封装接口并调用

1. 目标:

  1. 完成按钮跳转,导入完成(接口调用)之后,再跳回到原来的页面

2. 封装 导入excel的api接口

3. 在import页面导入使用

  1. async doImport(data) {
  2. try {
  3. const res = await importEmployee(data)
  4. console.log('importEmployee', res)
  5. this.$message.success('导入成功')
  6. // 页面后退
  7. this.$router.back()
  8. } catch (err) {
  9. console.log('importEmployee', err)
  10. this.$message.error('导入失败')
  11. }
  12. },
  13. // 成功之后干了啥? 下面三样
  14. // 1. 把数据从excel文件读入到浏览器内存
  15. handleSuccess({ header, results }) {
  16. console.log(header, results)
  17. // 2. 按接口要求 组装数据
  18. const data = this.transExcel(results)
  19. console.log('按接口要求 组装数据', data)
  20. // 3. 调用接口做上传
  21. this.doImport(data)
  22. },

image.png