《开源精选》是我们分享Github、Gitee等开源社区中优质项目的栏目，包括技术、学习、实用与各种有趣的内容。本期推荐的Sheet**是适用于传统和现代软件的新电子表格。

文件支持格式

Sheet** 社区版提供了久经考验的开源解决方案，用于从几乎任何复杂的电子表格中提取有用的数据，并生成适用于传统和现代软件的新电子表格。

Sheet** Pro提供超越数据处理的解决方案：轻松编辑复杂模板；用造型释放你内心的毕加索；使用图像/图表/数据透视表制作自定义工作表；评估公式表达式和端口计算到 Web 应用程序；自动化常见的电子表格任务等。

兼容性

Sheet**入门

安装

完整的浏览器独立构建保存dist/xlsx.full.min.**并可以直接添加到带有<script>标签的页面：

<script lang="javascript" src="dist/xlsx.full.min.**"></script>

每个独立的发布脚本都可以在https://CDN.sheet**.com/获得。最新版本使用latest标签：

<!-- use the latest version -->
<script lang="javascript" src="https://cdn.sheet**.com/XLSX-latest/package/dist/xlsx.full.min.**"></script>

可以通过版本引用特定的发行版：

<!-- use version 0.18.5 -->
<script lang="javascript" src="https://cdn.sheet**.com/xlsx-0.18.5/package/dist/xlsx.full.min.**"></script>

对于生产用途，应下载脚本并将其与其他脚本一起添加到公用文件夹中。

浏览器构建

完整的单文件版本生成于dist/xlsx.full.min.**

dist/xlsx.core.min.**省略代码页库（不支持 XLS 编码）

在dist/xlsx.mini.min.**. 与完整版本相比：

• 跳过代码页库（不支持 XLS 编码）
• 不支持 XLSB / XLS / Lotus 1-2-3 / SpreadsheetML 2003 / Numbers
• 节点流实用程序已删除

这些脚本也可在 CDN 上找到：

<!-- use xlsx.mini.min.** from the latest version -->
<script lang="javascript" src="https://cdn.sheet**.com/xlsx-latest/package/dist/xlsx.mini.min.**"></script>

ECMAScript 模块

ECMAScript 模块构建被保存到xlsx.m**并可以直接添加到带有script标签的页面，使用type="module"：

<script type="module">
import { read, writeFileXLSX } from "https://cdn.sheet**.com/xlsx-latest/package/xlsx.m**";

/* load the codepage support library for extended support with older formats */
import { set_cptable } from "https://cdn.sheet**.com/xlsx-latest/package/xlsx.m**";
import * as cptable from 'https://cdn.sheet**.com/xlsx-latest/package/dist/cpexcel.full.m**';
set_cptable(cptable);
</script>

Node** 包还公开了带有module参数的模块，Angular 和其他项目都支持该参数：

import { read, writeFileXLSX } from "xlsx";

/* load the codepage support library for extended support with older formats */
import { set_cptable } from "xlsx";
import * as cptable from 'xlsx/dist/cpexcel.full.m**';
set_cptable(cptable);

Sheet**用法

大多数涉及电子表格和数据的场景可以分为 5 个部分：

• 获取数据：数据可以存储在任何地方：本地或远程文件、数据库、HTML TABLE，甚至在 Web 浏览器中以编程方式生成。
• 提取数据：对于电子表格文件，这涉及解析原始字节以读取单元格数据。对于一般的 ** 数据，这涉及到重塑数据。
• 处理数据：从生成汇总统计数据到清理数据记录，这一步是问题的核心。
• 数据包：这可能涉及制作新的电子表格或使用 XML 序列化**ON.stringify或编写 XML 或简单地为 UI 工具展平数据。
• 发布数据：电子表格文件可以上传到服务器或本地写入。数据可以在 HTML TABLE 或数据网格中呈现给用户。

一个常见问题涉及从存储在 HTML 表中的数据生成有效的电子表格导出。在此示例中，将抓取页面上的 HTML TABLE，将在底部添加一行带有报告日期的行，并在本地生成和下载新文件。XLSX.writeFile负责打包数据并尝试本地下载：

// Acquire Data (reference to the HTML table)
var table_elt = document.getElementById("my-table-id");

// Extract Data (create a workbook object from the table)
var workbook = XLSX.utils.table_to_book(table_elt);

// Process Data (add a new row)
var ws = workbook.Sheets["Sheet1"];
XLSX.utils.sheet_add_aoa(ws, [["Created " new Date().toISOString()]], {origin:-1});

// Package and Release Data (`writeFile` tries to write and save an XLSB file)
XLSX.writeFile(workbook, "Report.xlsb");

read该库尝试使用从电子表格文件 ( / ) 中提取有用数据并从数据 ( / )readFile生成新电子表格文件的功能来简化步骤 2 和 4 。其他实用功能，例如 与其他常见数据源（如 HTML 表）一起使用。writewriteFiletable_to_book本文档和各种演示项目涵盖了步骤 1 和 5 的许多常见场景和方法。

获取和提取数据

解析工作簿

从电子表格字节中提取数据

var workbook = XLSX.read(data, opts);

该方法可以从存储在 ** 字符串、“二进制字符串”、Node** 缓冲区或类型化数组（或）read中的电子表格字节中提取数据。Uint8ArrayArrayBuffer

从本地文件读取电子表格字节并提取数据

var workbook = XLSX.readFile(filename, opts);

该readFile方法尝试在提供的路径中读取电子表格文件。浏览器一般不允许以这种方式读取文件（这被认为存在安全风险），尝试以这种方式读取文件会抛出错误。

例子

Node** 服务器中的本地文件

readFilefs.readFileSync在引擎盖下使用：

var XLSX = require("xlsx");

var workbook = XLSX.readFile("test.xlsx");

对于节点 E**，readFile未启用帮助程序。相反，fs.readFileSync 应该用于读取文件数据，以Buffer供使用XLSX.read：

import { readFileSync } from "fs";
import { read } from "xlsx/xlsx.m**";

const buf = readFileSync("test.xlsx");
/* buf is a Buffer */
const workbook = read(buf);

网页中用户提交的文件

// XLSX is a global from the standalone script

async function handleDropAsync(e) {
e.stopPropagation(); e.preventDefault();
const f = e.dataTransfer.files[0];
/* f is a File */
const data = await f.arrayBuffer();
/* data is an ArrayBuffer */
const workbook = XLSX.read(data);

/* DO SOMETHING WITH workbook HERE */
}
drop_dom_element.addEventListener("drop", handleDropAsync, false);

为了获得最大的兼容性，FileReader应使用 API：

function handleDrop(e) {
e.stopPropagation(); e.preventDefault();
var f = e.dataTransfer.files[0];
/* f is a File */
var reader = new FileReader();
reader.onload = function(e) {
var data = e.target.result;
/* reader.readAsArrayBuffer(file) -> data will be an ArrayBuffer */
var workbook = XLSX.read(data);

/* DO SOMETHING WITH workbook HERE */
};
reader.readAsArrayBuffer(f);
}
drop_dom_element.addEventListener("drop", handleDrop, false);

简单下载示例

/**
* **ON转换Excel
*/
function **onToSheet () {
let **on = [
{
"姓名": "EJ",
"性别": "男",
},
{
"姓名": "LSQ",
"性别": "女",
}
]

// 实例化一个工作簿
let book = XLSX.utils.book_new()

// 实例化一个Sheet
let sheet = XLSX.utils.**on_to_sheet(**on, {
header: ['姓名', '性别']
})

// 将Sheet写入工作簿
XLSX.utils.book_append_sheet(book, sheet, 'Sheet1')

// 写入文件，直接触发浏览器的下载
XLSX.writeFile(book, '**onToSheet.xlsx')
}

/**
* 数组转换Excel
*/
function arrayToSheet () {
let data = [
['姓名', '性别'],
['EJ', '男'],
['LSQ', '女']
]

// 实例化一个工作簿
let book = XLSX.utils.book_new()

// 实例化一个Sheet
let sheet = XLSX.utils.aoa_to_sheet(data)

// 将Sheet写入工作簿
XLSX.utils.book_append_sheet(book, sheet, 'Sheet1')

// 写入文件，直接触发浏览器的下载
XLSX.writeFile(book, 'arrayToSheet.xlsx')
}

—END—

开源协议：Apache-2.0 License

开源地址：https://github.com/Sheet**/sheet**