使用jspdf库可在前端生成PDF文件,首先通过cdn或npm引入库,创建jsPDF实例后可添加文本、图片、表格等内容,并支持自定义页面尺寸、方向及导出控制,结合autoTable插件能生成复杂表格,最终可保存为文件或获取Blob对象用于预览上传。

在网页开发中,有时需要在前端直接生成 PDF 文件,比如导出报表、简历或合同。javaScript 可以通过一些库来实现这一功能,无需依赖后端。下面介绍如何使用 jsPDF 这个流行的库来生成 PDF 文件,并进行基本的文件操作。
引入 jsPDF 库
jsPDF 是一个轻量级的 javascript 库,可以在浏览器中生成 PDF。你可以通过 CDN 引入,也可以使用 npm 安装。
CDN 方式:
<script src="https://cdnjs.cloudflare.com/ajax/libs/jspdf/2.5.1/jspdf.umd.min.js"></script>
npm 安装:
<pre class="brush:php;toolbar:false;">npm install jspdf
创建一个简单的 PDF 文件
引入库之后,就可以用几行代码生成一个基础 PDF。
const { jsPDF } = window.jspdf; // 创建一个新的 PDF 实例 const doc = new jsPDF(); // 添加文本 doc.setFontSize(16); doc.text("Hello, 世界!", 10, 10); // 保存文件 doc.save("example.pdf");
这段代码会生成一个包含“Hello, 世界!”文本的 PDF 文件,并自动下载为 example.pdf。
立即学习“Java免费学习笔记(深入)”;
添加更多内容(图片、表格等)
jsPDF 支持添加图像、表格、设置字体和样式等高级功能。
插入图片示例:
// 假设你有一张 base64 编码的图片 const imgData = 'data:image/jpeg;base64,/9j/4AAQSk...'; // 省略具体 base64 doc.addImage(imgData, 'JPEG', 10, 20, 50, 50); // x, y, width, height doc.save('with-image.pdf');
使用插件生成表格(需引入 autoTable):
doc.autoTable({ head: [['Name', 'Email']], body: [ ['Alice', 'alice@example.com'], ['Bob', 'bob@example.com'] ] }); doc.save('table.pdf');
记得引入 autoTable 插件:
<script src="https://cdnjs.cloudflare.com/ajax/libs/jspdf-autotable/3.5.23/jspdf.plugin.autotable.min.js"></script>
前端文件操作与导出控制
除了生成 PDF,你还可以对文件名、格式、页面方向等进行控制。
- 横向页面:new jsPDF(‘landscape’)
- A5 尺寸:new jsPDF(‘p’, ‘mm’, ‘a5’)
- 不自动下载:使用
doc.output('blob') 获取 Blob 对象,便于上传或预览
获取 Blob 示例:
const pdfBlob = doc.output('blob'); const file = new File([pdfBlob], "report.pdf", { type: "application/pdf" }); // 可用于上传到服务器
基本上就这些。使用 jsPDF 能满足大多数前端生成 PDF 的需求,操作简单,兼容性好。结合用户输入动态生成内容,非常适合做导出功能。注意内容过多时分页处理,避免文字溢出。基本上按结构一步步添加内容即可。


