msexcel-builder 使用与技术文档

本文档将详细介绍如何使用 msexcel-builder 库来创建和操作 MS Office Excel 文件。该库支持创建具有多个工作表的工作簿，并允许自定义单元格样式。

安装指南

首先，您需要在 Node.js 环境中安装 msexcel-builder 库。可以使用以下命令进行安装：

npm install msexcel-builder

项目的使用说明

安装完成后，您可以通过以下示例代码创建一个包含一个工作表和数据的工作簿：

var excelbuilder = require('msexcel-builder');

// 创建一个新的工作簿文件
var workbook = excelbuilder.createWorkbook('./', 'sample.xlsx');

// 创建一个新的工作表，包含10列和12行
var sheet1 = workbook.createSheet('sheet1', 10, 12);

// 填充一些数据
sheet1.set(1, 1, '标题');
for (var i = 2; i < 5; i++)
  sheet1.set(i, 1, '测试' + i);

// 保存工作簿
workbook.save(function(err) {
  if (err)
    throw err;
  else
    console.log('恭喜，您的工作簿已创建');
});

项目API使用文档

以下是 msexcel-builder 库的主要 API 方法：

createWorkbook(save_path, file_name)

创建一个新的工作簿文件。

• save_path - (字符串) 工作簿的保存路径。
• file_name - (字符串) 工作簿的文件名。

返回一个 Workbook 对象。

Workbook.createSheet(sheet_name, column_count, row_count)

创建一个新的工作表，指定列数和行数。

• sheet_name - (字符串) 工作表名称。
• column_count - (数字) 工作表列数。
• row_count - (数字) 工作表行数。

返回一个 Sheet 对象。

Workbook.save(callback)

保存当前工作簿。

• callback - (函数) 处理保存结果的回调函数。

Workbook.cancel()

取消当前工作簿的创建，丢弃所有数据。

Sheet.set(col, row, str)

设置单元格数据。

• col - (数字) 单元格列索引（从1开始）。
• row - (数字) 单元格行索引（从1开始）。
• str - (字符串) 单元格数据。

无返回值。

Sheet.width(col, width)

设置列宽。

Sheet.height(row, height)

设置行高。

Sheet.align(col, row, align)

设置单元格文本对齐样式。

Sheet.valign(col, row, valign)

设置单元格垂直对齐样式。

Sheet.wrap(col, row, wrap)

设置单元格文本换行样式。

Sheet.rotate(col, row, angle)

设置单元格文本旋转角度。

Sheet.font(col, row, font_style)

设置单元格字体样式。

Sheet.fill(col, row, fill_style)

设置单元格填充样式。

Sheet.border(col, row, border_style)

设置单元格边框样式。

Sheet.merge(from_cell, to_cell)

合并单元格范围。

项目安装方式

msexcel-builder 库的安装方式已在“安装指南”部分介绍，这里不再赘述。

通过本文档，您应该能够了解如何使用 msexcel-builder 库创建和操作 Excel 文件，并掌握其 API 方法的基本用法。