1.1.1 • Published 4 months ago
p-export-excel v1.1.1
p-export-excel 官方文档
p-export-excel 是一个导出 Excel 的 js 插件,支持丰富的自定义配置选项,能够轻松生成 xlsx 和 csv 格式的数据报表。
配置
- fileName: 文件名,字符串。
- fileType: 文件类型,字符串(值为 xlsx、csv,默认为 xlsx)。
- sheetStyle: 工作表样式,支持 css 样式,字符串。
- rowStyle: 数据行样式,支持 css 样式,字符串。
- cellStyle: 单元格样式,支持 css 样式,字符串。
- resType: 资源类型,字符串(值为 download、file、base64、blob 以及 bloburl,默认为 download)。
- isPreview: 是否预览,布尔值(默认为 false)。
- sheets: 工作表,数组(值为对象)。
- sheetName: 工作表名称,字符串。
- style: 工作表样式,支持 css 样式,字符串。
- rowStyle: 数据行样式,支持 css 样式,字符串。
- cellStyle: 单元格样式,支持 css 样式,字符串。
- rows: 数据行,数组(值为对象)。
- style: 数据行样式,支持 css 样式,字符串。
- cellStyle: 单元格样式,支持 css 样式,字符串。
- cells: 单元格,数组(值为对象或数值或字符串)。
- text: 单元格内容,字符串或数字。
- style: 单元格样式,支持 css 样式,字符串。
- colspan: 单元格横向合并列数,数字。
- rowspan: 单元格纵向合并行数,数字。
安装引入
npm 安装
npm install p-export-excel --save
esm 引入
import pExportExcel from "p-export-excel";
cdn 引入
<script src="https://unpkg.com/p-export-excel@[version]/lib/p-export-excel.umd.js"></script>
使用示例
// 简约数据表
const option = {
fileName: "示例数据表",
sheets: [
{
rows: [
{
cells: ["Cell 1", "Cell 2", "Cell 3"],
},
{
cells: ["Cell 4", "Cell 5", "Cell 5"],
},
],
},
],
};
// 复杂数据表
const option = {
fileName: "复杂数据表",
rowStyle: "height: 40px;vertical-align: middle;",
cellStyle: "border: 1px solid #eee;width: 100px;text-align: center;",
sheets: [
{
sheetName: "学生名单",
style: "font-size: 16px;font-family: 微软雅黑;",
rows: [
{
style: "font-weight: bold;color: #fff;font-size: 18px;",
cellStyle: "background-color: #29B8DB;border: 1px solid #fff;",
cells: [
{
text: "三年级(1)班全体学生名单",
colspan: 5,
},
],
},
{
style: "font-weight: bold;color: #fff;",
cellStyle: "background-color: #29B8DB;border: 1px solid #fff;",
cells: [
"序号",
"姓名",
"性别",
"年龄",
{
text: "备注",
style: "width: 200px;",
},
],
},
{
cells: ["1", "张三", "男", 12, ""],
},
{
cellStyle: "background-color: #F5F5F5;",
cells: ["2", "李四", "女", 11, ""],
},
{
cells: ["3", "王五", "男", 12, "校长侄子"],
},
{
cellStyle: "background-color: #F5F5F5;",
cells: ["4", "赵六", "女", 11, ""],
},
],
},
],
};
pExportExcel(option)
.then((e) => {
console.log(e);
})
.catch((err) => {
console.log(err);
});
注意事项
- 1.xlsx 文件的字体单位为磅(pt),所以样式中设置的字体大小(px)将被转换,具体公式为 pt≈72*px/DPI。
- 2.xlsx 文件重复设置样式会按照 css 的原则,后者覆盖前者。
- 3.csv 文件多表导出仅会导出第一个表。
- 4.csv 文件仅导出文本,不支持样式以及单元格合并等。
- 5.所有配置项均为非必填项。