js-xlsx + handsontable + echarts 实现在前端导入 excel 数据并生成 echart 报表
前言
最近都在做类似 ERP 的项目, 所以呢, 又碰到一个比较变态的需求(至少对我来说是), 在前端导入 excel 文件, 然后在浏览器里面预览和编辑,最后再选择一些数据, 用 echarts 生成报表.
依赖
https://github.com/SheetJS/js-xlsx 读取 excel 数据到 js
https://github.com/handsontable/handsontable 类似 Excel 一样显示和编辑列表数据
https://github.com/apache/incubator-echarts 一个生成各种报表的库
数据导入
数据导入这边需要用到 浏览器的 FileReader 对象 的 readAsBinaryString() 函数, 把选择的文件读取出来, 然后再监听 FileReader 对象的 onload 事件 , 在 onload 事件 的回调函数中, 我们可以获取到 读取的二进制数据. 这里顺便提一下, FileReader 对象提供以下方法, 用来读取各种格式的数据(参考自 MDN)
- FileReader.readAsArrayBuffer() // 读取文件的 ArrayBuffer 数据对象.
- FileReader.readAsBinaryString() // 读取文件的原始二进制数据
- FileReader.readAsDataURL() // 返回一个 URL 格式的字符串以表示所读取文件的内容
- FileReader.readAsText() // 返回一个字符串以表示所读取的文件内容
tips: 需要注意的是 readXxxxx() 函数, 是不直接返回读取结果的, 因为读取这个动作异步的.
readAsBinaryString 读取到的内容应该是一个二进制的字符串, 这个时候, 需要调用 js-xlsx 的 read 方法, read 返回的是一个可读性很强的对象了, 我看了一下, 里面有关于表格的属性很多都有 , 如 样式, vsb 宏, sheets 等等 (反正我对 excel 也不熟, 认识的也就这些哈),
npm i xlsx
复制代码
- import XLSX from 'xlsx'
- ...
- let res = XLSX.read(data, {type: 'binary'})
- let sheetName = res.Sheets[res.SheetNames[0]]
- let table = XLSX.utils.sheet_to_json(sheetName, {header: 'A', raw: true, defval: ' '})
复制代码
这里的 res 得到的我猜是 excel 表格原有的数据, 里面包含上面说的很多种数据, 而正常情况下, 我们需要的往往只是第一个 sheet 里面的 纯数据, 所以调用 XLSX.utils.sheet_to_json 获取第一个 sheet 的数据, table 拿到的应该是一个我们熟悉的数组了. 这个时候如果你只是单纯的渲染的话, 你甚至可以就此打住, 自己写一个渲染方法 (比如字符串拼接哈) 把数据渲染出来即可.
如果单纯的显示无法满足你的需求, 那么你可能需要 handsontable 了.
tips: sheet_to_json 的 第二个参数里面的 header, 可以传数字, 也可以转'A', 两个的主要区别在于转化出来的表第一行如果是空行会不会正常显示, 传'A' 会正常显示, 传数字的话, 如果表格的第一行有空白单元格, 表格会错乱.
数据展示
首先当然是安装, 我的项目是基于 vue 的, 所以要安装 vue 版本的, 其他框架的, 只要安装响应的版本即可.
npm i @handsontable/vue
复制代码
然后就可以直接这么用
- <template>
- <HotTable :settings="settings"></HotTable>
- </template>
- <script>
- import HotTable from '@handsontable/vue'
- export default {
- ...
- components: {HotTable}
- ...
- }
- </script>
复制代码
模板里面的 settings 是 handsontable 的一些配置, 每个项目的需求不同, 配置也不同, 这里就不列举出来了, 上面获取到的 table 在这里要赋值给 settings.data
我这里用 handsontable 显示数据的目的, 是让用户可以清晰的看到上传的表的数据和结构, 可以删除屌部分无用的数据, 减少冗余.
生成报表
数据都处理完了之后, 就是生成报表了, 报表这里稍微做的灵活了一点, 是要让用户根据上传的数据, 自己选择字段, 然后用 echart 去生成对应的报表.
为了偷懒降低复杂度, 我这里只提供了 3 种报表类型供选择, 分别是 饼图, 柱状图, 折线图, 稍微分析 echart 的配置手册, 我发现各种类型的图表, 其实主要的区别在 series 配置项下面, 其他位置几乎没啥区别 就算有区别, 也被我无视 . 最终的实现大概是这样
- let option = {
- title: {...},
- tooltip: {...},
- xAxis: {...},
- yAxis: {...},
- toolbox: {...},
- }
- switch (type) {
- case 'pie' :
- option.series = {...}
- break
- case 'pie' :
- option.series = {...}
- break
- case 'pie' :
- option.series = {...}
- break
- }
- myChart.setOption(option)
复制代码
echart 第一次渲染完以后, 如果改变 option 的数据然后重新渲染, 新的 option 数据是采用追加的方式加进去的, 类似 javascript 的 Object.assign(), 所以如果新的数据没办法完全覆盖掉就旧的数据的话, 旧的那些没有被覆盖掉的数据, 还会渲染出来. 我对这种情况的处理方法是调用 dispose.dispose() 把实例销毁掉, 然后重新创建一个新实例, 设置新的 option
最后
本文用的代码都比较基础, 就不上传了, 有需要的童鞋可以私下发邮件找我要.
来源: https://juejin.im/post/5b924d096fb9a05cf67a6971