js-xlsx挖坑
安装
1 | npm install xlsx --save |
使用
1 | import XLSX from 'xlsx'; |
概念名词
workbook [excel文档]
首先是workbook,可以把它看作是一个excel文档。
我们要用xlsx导出excel,就是要按规范创建workbook
一个简单的workbook对象是这样的
1 | const workbook = { |
sheet [工作表]
从workbook对象下面延伸出来的是sheet对象,很容易理解,它对应这个excel文档下面的工作表
一个workbook可以有多个sheet,就像下面这个对象这样,等于是有三个工作表的excel文档
sheet的常用配置项:
1 | const workbook = { |
cell [单元格]
从sheet 对象下面延伸出来的是cell 对象,对应的是工作表下的单元格,cell 对象键名是A1,B1这样与excel一致的键名
1 | const workbook = { |
js-xlsx提供了一个方法XLSX.utils.encode_cell来转换键名
1 | XLSX.utils.encode_cell({ |
知道相应的行列值就能方便的转换成键名了,需要注意的是行列是从0开始不是从1开始
1 | XLSX.utils.encode_cell({c: 0, r: 0});//A1 |
cell单元格对象的配置项
键名 | 作用 |
---|---|
v | 初始值 (请参见数据类型t 部分) |
w | 格式化文本 (如果适用) |
t | 单元格数据类型: b Boolean, n Number, e error, s String, d Date |
f | 单元格编码为A1样式的字符串(如果适用) |
F | 如果公式为数组公式,则包含数组的范围(如适用) |
r | 富文本编码(如适用) |
h | HTML 富文本呈现(如适用) |
c | 单元格注释 |
z | 与单元格关联的数字格式字符串(如果请求) |
l | 单元格超链接对象(.Target holds link, .Tooltip is tooltip) |
s | 单元格的样式/主题(如果适用) |
XLSX.write(workbook, options) 生成excel数据
第一个参数传入写好的workbook
,第二个参数是配置项
write options 配置项
键名 | 默认值 | 描述 |
---|---|---|
type | 输出数据编码(见下表Output Type) | |
cellDates | false | 存储日期为d类型(默认为n) |
bookSST | false | 生成共享字符串表 |
bookType | “xlsx” | 文档格式类型 |
sheet | “” | 单页格式的工作表名称 |
compression | false | 对基于ZIP的格式使用ZIP压缩 |
Props | 重写工作簿时重写工作簿属性 | |
themeXLSX | Override theme XML when writing XLSX/XLSB/XLSM |
Output Type
type | output |
---|---|
“base64” | string: Base64 encoding of the file |
“binary” | string: binary string (byte n is data.charCodeAt(n)) |
“string” | string: JS string (characters interpreted as UTF8) |
“buffer” | nodejs Buffer |
“file” | string: path of file that will be created (nodejs only) |
感觉上面学习的内容已经足够导出一个简单的excel了,我先来试下
1 | const workbook = { |
运行 顺利生成export.xlsx