xlsx.js：基于 JavaScript 的 Excel 文件读写库
在现代的 web 开发中，处理 Excel 文件已成为一个常见的需求。对于很多需要进行数据分析、报表生成或者数据导入导出的项目，能够方便地读写 Excel 文件是非常重要的。xlsx.js 是一个流行的 JavaScript 库，专门用于在浏览器和 Node.js 环境中读写 Excel 文件。本文将介绍这个库的基本用法，并给出一些示例代码。
什么是 xlsx.js？
xlsx.js 是一个轻量级的库，能够解析和生成 .xls 和 .xlsx 格式的文件。它支持多种数据类型，如数字、字符串和日期等，同时还提供了简单易用的 API 进行数据的读取和写入。在前端项目中，使用 xlsx.js 可以极大地简化与 Excel 文件的交互。
安装
在使用 xlsx.js 前，首先需要将其安装到你的项目中。可以通过 npm 或者直接引入 CDN 的方式来使用。
使用 npm 安装
npm install xlsx
使用 CDN
<script src="https://cdnjs.cloudflare.com/ajax/libs/xlsx/0.17.5/xlsx.full.min.js"></script>
读取 Excel 文件
我们可以使用 xlsx.js 来读取用户上传的 Excel 文件。首先需要在 HTML 中添加一个文件上传的 input 元素。
<input type="file" id="upload" />
然后，使用 JavaScript 处理文件读取和解析。以下是一个简单的示例代码：
document.getElementById('upload').addEventListener('change', function(event) {
const file = event.target.files[0]; // 获取文件
const reader = new FileReader();
reader.onload = function(e) {
const data = new Uint8Array(e.target.result); // 将读取的数据转换为 Uint8Array
const workbook = XLSX.read(data, { type: 'array' }); // 解析 Excel 文件
const firstSheetName = workbook.SheetNames[0]; // 获取第一个表单的名称
const worksheet = workbook.Sheets[firstSheetName]; // 获取第一个表单
// 将数据转化为 JSON 格式
const jsonData = XLSX.utils.sheet_to_json(worksheet);
console.log(jsonData); // 打印数据到控制台
};
reader.readAsArrayBuffer(file); // 读取文件为 ArrayBuffer
});
在上面的代码中，我们首先创建了一个文件上传的事件监听器。当用户选择文件后，使用 FileReader 读取文件。读取完成后，通过 XLSX.read 方法将数据解析为工作簿对象，然后获取第一个工作表的数据并转化为 JSON 格式。
写入 Excel 文件
除了读取 Excel 文件，xlsx.js 还支持写入 Excel 文件。以下是一个创建新 Excel 文件并下载的示例代码：
function exportToExcel(data) {
const worksheet = XLSX.utils.json_to_sheet(data); // 将 JSON 数据转换为工作表
const workbook = XLSX.utils.book_new(); // 创建一个新的工作簿
XLSX.utils.book_append_sheet(workbook, worksheet, "Sheet1"); // 将工作表添加到工作簿
// 生成文件并触发下载
XLSX.writeFile(workbook, 'output.xlsx');
}
// 示例数据
const jsonData = [
{ Name: "张三", Age: 25, City: "北京" },
{ Name: "李四", Age: 30, City: "上海" },
];
// 调用导出函数
exportToExcel(jsonData);
在这段代码中，我们首先将 JSON 数据转换为工作表，然后创建一个新的工作簿，并将工作表添加到工作簿中。最后，使用 XLSX.writeFile 方法生成 Excel 文件并自动下载。
总结
xlsx.js 是一个强大的库，使得在 JavaScript 中读写 Excel 文件变得简单而高效。无论是在浏览器中还是 Node.js 环境下，使用这个库都能轻松处理 Excel 文件，满足各种数据处理的需求。通过使用简单的 API，开发者能够快速实现数据的读取和写入操作，为项目增加更多的灵活性和功能。希望上面的示例代码和说明能够帮助你更好地理解和使用 xlsx.js。
