基于NodeJS和浏览器的PDF文档引擎——PDFKit

介绍

PDFKit是一个用于Node和浏览器的PDF文档生成库，可以轻松创建复杂的多页面可打印文档。API包含可链接性，包括低级功能以及更高级功能的抽象。PDFKit API设计简单，因此生成复杂文档通常与一些函数调用一样简单。最直接的好处就是节省了服务器端的资源，让生成工作在本地完成！

如何获取？

由于最近限制颇多，不便于直接放链接，截图都不行，大家可以直接到Github搜索

安装使用

使用npm包管理

npm install pdfkit

创建文档

创建PDFKit文档非常简单。只需要引用pdfkit的JavaScript源文件中的模块并创建PDFDocument该类的实例

const PDFDocument = require('pdfkit'); const doc = new PDFDocument;

PDFDocument实例是可读的节点流。它们不会自动保存在任何地方，但您可以调用管道方法将PDF文档的输出发送到正在写入的另一个可写节点流。完成文档后，请调用end方法以完成它。下面是一个示例，说明如何管道传输文件或HTTP响应。

doc.pipe(fs.createWriteStream('/path/to/file.pdf')); // 写pdf doc.pipe(res); // HTTP响应 // 添加内容 doc.end();

浏览器使用

在浏览器中使用PDFKit与在Node中使用它完全相同，除非你想要将输出通过管道传输到浏览器中支持的目标，例如Blob。Blob可用于生成URL以允许通过iframe直接在浏览器中显示生成的PDF，或者它们可用于将PDF上传到服务器，或在用户的浏览器中触发下载。

// 引入依赖 const PDFDocument = require('pdfkit'); const blobStream = require('blob-stream'); // 同样的创建方式 const doc = new PDFDocument; //传输文档到Blob const stream = doc.pipe(blobStream()); //像以往一样将内容添加到文档 // 最终得到Blob doc.end(); stream.on('finish', function() { // 得到一个可以随心所欲的Blob const blob = stream.toBlob('application/pdf'); //或获取blob URL以在浏览器中显示 const url = stream.toBlobURL('application/pdf'); iframe.src = url; });

添加页

这个地方除非你设置autoFirstPage: false，不然PDFkit会自动给你添加第一页，后续页面你需要自己添加

doc.addPage() //事件监听 doc.on('pageAdded', () => doc.text("Page Title"));

还可以为页面设置一些选项，例如其大小和方向以及边距等

// 所有页面添加50边距 doc.addPage({ margin: 50}); // 在每一侧添加不同的边距 doc.addPage({ margins: { top: 50, bottom: 50, left: 72, right: 72 } });

切换到之前的页面

bufferPages: true// 配置 //调用 doc.switchToPage(pageNumber)

// 创建一个文档，bufferPages设置为true let i; let end; const doc = new PDFDocument({ bufferPages: true}); // 添加一些内容 doc.addPage(); // ... doc.addPage(); //查看缓冲页面的范围 const range = doc.bufferedPageRange(); // => { start: 0, count: 2 } for (i = range.start, end = range.start + range.count, range.start <= end; i < end; i++;) { doc.switchToPage(i); doc.text(`Page ${i + 1} of ${range.count}`); } // 手动刷新已缓冲的页面 doc.flushPages(); doc.end();

设置文档元数据

PDF文档可以具有与其相关联的各种元数据，例如标题或文档的作者。可以通过将该信息添加到doc.info对象中，或者通过在创建时将info对象传递到文档中来添加该信息。

以下是可以添加到文档元数据的所有属性的列表。根据PDF规范，每个属性必须首字母大写。

Title - 文件的标题
Author - 作者的姓名
Subject - 文件的主题
Keywords - 与文档关联的关键字
CreationDate - 文档创建的日期（由PDFKit自动添加）
ModDate - 上次修改文档的日期

加密和访问权限

PDF规范允许你在打开文件时加密PDF文件且需要密码，以及设置用户可以对PDF文件执行的操作的权限。要启用加密，在创建时提供用户密码PDFDocument的options对象。提供用户密码时将对PDF文件进行加密，并在打开文件时提示用户输入密码以解密文件。

userPassword - 用户密码（字符串值）

要设置PDF文件的访问权限，您需要option在创建时在对象中提供所有者密码和权限设置PDFDocument。默认情况下，不允许所有操作。您需要明确允许某些操作。

ownerPassword - 所有者密码（字符串值）
permissions - 指定PDF文件权限的对象

permissions对象中允许以下设置：

printing - 是否允许打印。指定"lowResolution"允许降级打印，或"highResolution"允许以高分辨率打印
modifying - 是否允许修改文件。指定true允许修改文档内容
copying - 是否允许复制文本或图形。指定true允许复制
annotating - 是否允许注释，填写表格。指定true允许注释和表单填写
fillingForms - 是否允许填写表格和签字。指定true允许填写表单字段和签名
contentAccessibility - 是否允许复制文本以便访问。指定true允许复制可访问性
documentAssembly - 是否允许装配文件。指定true允许文档组装