在前端开发中，生成 PDF 文件是一个非常常见的需求，而 pdfer-api 就是一个方便快捷的 npm 包，可以帮助我们轻松地实现生成 PDF 文件的功能。本文将介绍 pdfer-api 的使用方法，包括安装、基本使用、高级使用以及常见问题解决方法。
安装
在终端中输入以下命令进行安装：
npm install pdfer-api
基本使用
pdfer-api 可以帮助我们将 HTML 内容转化为 PDF 文件，实现方法非常简单：
-- -------------------- ---- -------
----- ----- - ---------------------
----- -- - --------------
----- ----------- - ---------- -------------
----- ------- - -
----- ----------
--
------------------ --------
--------- -- -
-------------------------- -- ------
--
---------- -- -
-------------------
---在上述代码中，我们首先引入 pdfer-api 模块和 fs 模块。然后，我们定义了一个 HTML 字符串作为生成 PDF 文件的内容，并将其传递给 pdfer。
options 参数是一个对象，它包含文件路径、页面大小、页面方向等选项。在本例中，我们只指定了文件路径。
pdfer 返回一个 promise 对象，如果成功，我们将在控制台上看到生成 PDF 文件的路径。如果失败，将会输出错误信息。
高级使用
pdfer-api 还提供了一些高级功能，如以下所示：
页面大小和方向
可以在 options 中指定页面大小和方向：
const options = {
path: 'test.pdf',
width: '150mm', // 页面宽度
height: '210mm', // 页面高度
orientation: 'portrait' // 页面方向
};多个页面
也可以将多个 HTML 内容拼接成一个 PDF 文件：
-- -------------------- ---- -------
----- ----- - ---------------------
----- -- - --------------
----- ----------- - -
--------- -----------
-------- --------
---- ------------------------ ---------------
--------- -----------
--------- --------
--
----- ------- - -
----- -----------
------ --------
------- --------
------------ ----------
--
------------------ --------
--------- -- -
--------------------------
--
---------- -- -
-------------------
---在上述代码中，我们创建了一个包含两个页面的 HTML 字符串。我们在第一个页面的末尾添加了 page-break，这将告诉 pdfer 在该位置分页。然后我们就可以得到一个包含两个页面的 PDF 文件了。
自定义样式
pdfer-api 还支持自定义样式。在 options 参数中加入 css 属性：
const options = {
path: 'test.pdf',
css: '.title { color: red }'
};在上述代码中，我们定义了一个类名为 title 的 CSS 样式。我们可以在 HTML 内容中应用此样式：
<h1 class="title">Hello pdfer!</h1>
其它更多高级用法可以在官方文档中查看。
常见问题解决方法
中文乱码
在生成 PDF 文件时，可能出现中文乱码的情况。这是因为 pdfer-api 默认使用了 Helvetica 字体，而该字体并不支持中文。
解决方法是在 options 参数中指定使用支持中文的字体，如以下所示：
const options = {
path: 'test.pdf',
font: 'simhei.ttf'
};在上述代码中，我们使用了 simhei 字体，它支持中文。
生成空白文件
如果生成的 PDF 文件是空白的，可能是因为 pdfer-api 默认使用了 5 秒的时间去渲染 HTML 内容，而有些内容可能需要花费更长的时间才能渲染完毕。
解决方法是在 options 参数中指定延迟时间，如以下所示：
const options = {
path: 'test.pdf',
delay: 10000 // 10 秒
};在上述代码中，我们指定了延迟时间为 10 秒。
总结
pdfer-api 是一个非常方便快捷的 npm 包，可以帮助我们轻松地实现 HTML 内容转化为 PDF 文件的功能。我们可以通过本文介绍的方法进行安装和基本使用，同时还可以利用高级功能实现更为复杂的应用。在使用过程中，如果遇到问题，也可以根据本文提供的解决方案进行排查。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/126134