文章目录

发现宝藏1. 简介2. 安装3. 创建工作簿4. 设置工作簿属性5. 添加工作表6.删除工作表7.访问工作表8. 列操作9. 行操作10. 单元格操作

发现宝藏

前些天发现了一个巨牛的人工智能学习网站，通俗易懂，风趣幽默，忍不住分享一下给大家。【宝藏入口】。

ExcelJS 是一个强大的 JavaScript 库，它允许你在 Node.js 和浏览器环境中读取、操作和写入 Excel 文件。本文将带你了解 ExcelJS 的基本用法，帮助你快速上手这个强大的工具。

1. 简介

ExcelJS 是一个开源的 JavaScript 库，支持读写 XLSX 和 CSV 格式的 Excel 文件。它具有以下特点：

支持丰富的 Excel 功能，如单元格样式、公式、图表等。良好的文档和社区支持。跨平台，可在 Node.js 和浏览器环境中使用。

2. 安装

在开始使用 ExcelJS 之前，需要先进行安装。以下是在 Node.js 环境中的安装方法：

<code>npm install exceljs

如果你在浏览器环境中使用，可以直接从 GitHub 仓库下载 exceljs.js 文件。

3. 创建工作簿

首先，我们需要创建一个工作簿（Workbook）对象，然后才能进行其他操作。

const workbook = new ExcelJS.Workbook();

4. 设置工作簿属性

可以为工作簿设置一些基本属性，如创建者、最后修改者、创建时间等。

workbook.creator = 'Me';

workbook.lastModifiedBy = 'Her';

workbook.created = new Date(1985, 8, 30);

workbook.modified = new Date();

workbook.lastPrinted = new Date(2016, 9, 27);

// 将工作簿日期设置为 1904 年日期系统

workbook.properties.date1904 = true;

5. 添加工作表

工作簿（Workbook）由多个工作表（Worksheet）组成。以下是如何添加一个工作表：

const sheet = workbook.addWorksheet('My Sheet');

使用 addWorksheet 函数的第二个参数来指定工作表的选项。

// 创建带有红色标签颜色的工作表

const sheet = workbook.addWorksheet('My Sheet', { properties:{ tabColor:{ argb:'FFC0000'}}});

// 创建一个隐藏了网格线的工作表

const sheet = workbook.addWorksheet('My Sheet', { views: [{ showGridLines: false}]});

// 创建一个第一行和列冻结的工作表

const sheet = workbook.addWorksheet('My Sheet', { views:[{ xSplit: 1, ySplit:1}]});

// 使用A4设置的页面设置设置创建新工作表 - 横向

const worksheet = workbook.addWorksheet('My Sheet', {

pageSetup:{ paperSize: 9, orientation:'landscape'}

});

// 创建一个具有页眉页脚的工作表

const sheet = workbook.addWorksheet('My Sheet', {

headerFooter:{ firstHeader: "Hello Exceljs", firstFooter: "Hello World"}

});

// 创建一个冻结了第一行和第一列的工作表

const sheet = workbook.addWorksheet('My Sheet', { views:[{ state: 'frozen', xSplit: 1, ySplit:1}]});

6.删除工作表

// 创建工作表

const sheet = workbook.addWorksheet('My Sheet');

// 使用工作表 id 删除工作表

workbook.removeWorksheet(sheet.id)

7.访问工作表

// 遍历所有工作表

// 注意： workbook.worksheets.forEach 仍然是可以正常运行的， 但是以下的方式更好

workbook.eachSheet(function(worksheet, sheetId) {

// ...

});

// 按 name 提取工作表

const worksheet = workbook.getWorksheet('My Sheet');

// 按 id 提取工作表

const worksheet = workbook.getWorksheet(1);

8. 列操作

可以为工作表设置列宽、列名等属性。

// 添加列标题并定义列键和宽度

// 注意：这些列结构仅是构建工作簿的方便之处，除了列宽之外，它们不会完全保留。

worksheet.columns = [

{ header: 'Id', key: 'id', width: 10 },

{ header: 'Name', key: 'name', width: 32 },

{ header: 'D.O.B.', key: 'DOB', width: 10, outlineLevel: 1 }

];

// 通过键，字母和基于1的列号访问单个列

const idCol = worksheet.getColumn('id');

const nameCol = worksheet.getColumn('B');

const dobCol = worksheet.getColumn(3);

// 设置列属性

// 注意：将覆盖 C1 单元格值

dobCol.header = 'Date of Birth';

// 注意：这将覆盖 C1:C2 单元格值

dobCol.header = ['Date of Birth', 'A.K.A. D.O.B.'];

// 从现在开始，此列将以 “dob” 而不是 “DOB” 建立索引

dobCol.key = 'dob';

dobCol.width = 15;

// 如果需要，隐藏列

dobCol.hidden = true;

// 为列设置大纲级别

worksheet.getColumn(4).outlineLevel = 0;

worksheet.getColumn(5).outlineLevel = 1;

// 列支持一个只读字段，以指示基于 `OutlineLevel` 的折叠状态

expect(worksheet.getColumn(4).collapsed).to.equal(false);

expect(worksheet.getColumn(5).collapsed).to.equal(true);

// 遍历此列中的所有当前单元格

dobCol.eachCell(function(cell, rowNumber) {

// ...

});

// 遍历此列中的所有当前单元格，包括空单元格

dobCol.eachCell({ includeEmpty: true }, function(cell, rowNumber) {

// ...

});

// 添加一列新值

worksheet.getColumn(6).values = [1,2,3,4,5];

// 添加稀疏列值

worksheet.getColumn(7).values = [,,2,3,,5,,7,,,,11];

// 剪切一列或多列（右边的列向左移动）

// 如果定义了列属性，则会相应地对其进行切割或移动

// 已知问题：如果拼接导致任何合并的单元格移动，结果可能是不可预测的

worksheet.spliceColumns(3,2);

// 删除一列，再插入两列。

// 注意：第4列及以上的列将右移1列。

// 另外：如果工作表中的行数多于列插入项中的值，则行将仍然被插入，就好像值存在一样。

const newCol3Values = [1,2,3,4,5];

const newCol4Values = ['one', 'two', 'three', 'four', 'five'];

worksheet.spliceColumns(3, 1, newCol3Values, newCol4Values);

9. 行操作

以下是如何添加行、设置行高、隐藏行等操作。

添加行

// 通过键值对在当前最后一行后添加几行，使用列键

worksheet.addRow({ id: 1, name: 'John Doe', dob: new Date(1970,1,1)});

worksheet.addRow({ id: 2, name: 'Jane Doe', dob: new Date(1965,1,7)});

// 通过连续数组添加一行（分配给列 A、B 和 C）

worksheet.addRow([3, 'Sam', new Date()]);

// 通过稀疏数组添加一行（分配给列 A、E 和 I）

const rowValues = [];

rowValues[1] = 4;

rowValues[5] = 'Kyle';

rowValues[9] = new Date();

worksheet.addRow(rowValues);

// 添加一行并继承样式

// 这新行将具有与最后一行相同的样式

// 并返回为行对象

const newRow = worksheet.addRow(rowValues, 'i');

// 添加多行

const rows = [

[5,'Bob',new Date()], // 通过数组添加行

{ id:6, name: 'Barbara', dob: new Date()} // 通过对象添加行

];

// 添加新行并返回它们作为行对象数组

const newRows = worksheet.addRows(rows);

// 添加多行并继承样式

// 这些新行将具有与最后一行相同的样式

// 并返回它们作为行对象数组

const newRowsStyled = worksheet.addRows(rows, 'i');

插入行

// 在指定位置插入一行，可以传递值和样式

// pos: 要插入行的位置

// value: 要插入的行的值，可以是对象或数组

// style: 可选参数，指定新行的样式处理方式，默认为 'n'（无样式处理）

// 通过键值对在位置1插入几行，每次插入都会下移现有行

worksheet.insertRow(1, { id: 1, name: 'John Doe', dob: new Date(1970,1,1)});

worksheet.insertRow(1, { id: 2, name: 'Jane Doe', dob: new Date(1965,1,7)});

// 通过连续数组在位置1插入一行（分配给列 A, B & C）

worksheet.insertRow(1, [3, 'Sam', new Date()]);

// 通过稀疏数组在位置1插入一行（分配给列 A, E & I）

var rowValues = [];

rowValues[1] = 4;

rowValues[5] = 'Kyle';

rowValues[9] = new Date();

// 插入新行并返回作为行对象

const insertedRow = worksheet.insertRow(1, rowValues);

// 插入一行，并继承上方行的样式

// 这新行将具有与上方行相同的样式

// 并返回作为行对象

const insertedRowInherited = worksheet.insertRow(1, rowValues, 'i');

// 插入一行，保持原始样式

// 这新行将保持它之前的样式

// 并返回作为行对象

const insertedRowOriginal = worksheet.insertRow(1, rowValues, 'o');

// 在位置1插入多行，当前位置1及之后的行将下移2行

var rows = [

[5,'Bob',new Date()], // 通过数组添加行

{ id:6, name: 'Barbara', dob: new Date()} // 通过对象添加行

];

// 插入新行并返回它们作为行对象数组

const insertedRows = worksheet.insertRows(1, rows);

// 插入多行，并继承上方行的样式

// 这些新行将具有与上方行相同的样式

// 并返回它们作为行对象数组

const insertedRowsInherited = worksheet.insertRows(1, rows, 'i');

// 插入多行，保持原始样式

// 这些新行将保持它们在 'pos' 位置的原始样式

const inserted&nbsp;<svg t="1708604394457" class="icon" viewBox="0 0 1024 1024" version="1.1" xmlns="http://www.w3.org/2000/svg" p-id="2125" width="200" height="200"><path d="M512 64c247.424 0 448 200.576 448 448s-200.576 448-448 448S64 759.424 64 512 264.576 64 512 64z m0 256a192 192 0 1 0 0 384 192 192 0 0 0 0-384z" fill="#5b79e4" p-id="2126"></path></svg>code>

10. 单元格操作