HOWTO · JavaScript
如何用 JavaScript 打印 PDF 文件
了解如何使用 JavaScript iframe 或 Print.js 库请求浏览器打印 PDF。
本页内容
您可以让用户通过按钮在浏览器的打印界面中打开 PDF,而无需让他们先下载并打开文件。JavaScript 可以通过 iframe 请求打印,或者您可以使用 Print.js 等库。浏览器及其 PDF 查看器控制打印界面;用户仍需确认并完成打印任务。
在 JavaScript 中使用 iframe 标签打印 PDF 文件
iframe 将另一个文档嵌入页面中。对于这种方法,浏览器必须能够访问 PDF 的 URL,并且页面的脚本需要能够访问 iframe 窗口。将 PDF 与页面置于同一来源下提供,可避免此示例中的跨来源访问限制。
在页面中添加一个按钮,并加载定义 printPdf 的 JavaScript:
<button id="print-pdf" type="button">Print PDF</button>
<script src="index.js"></script>
PDF 的 URL 相对于页面而言。将其更改为您应用中提供 PDF 的路由或 URL。在 index.js 中,创建一个小的、位于屏幕外的 iframe,并等待其 load 事件,然后再请求其窗口进行打印:
function printPdf(pdfUrl) {
const frame = document.createElement('iframe');
frame.style.position = 'fixed';
frame.style.left = '-10000px';
frame.style.width = '1px';
frame.style.height = '1px';
frame.style.border = '0';
frame.addEventListener('load', () => {
const printWindow = frame.contentWindow;
if (!printWindow) return;
printWindow.focus();
printWindow.print();
}, { once: true });
frame.src = pdfUrl;
document.body.appendChild(frame);
}
if (typeof document !== 'undefined') {
const button = document.querySelector('#print-pdf');
if (button) {
button.addEventListener('click', () => printPdf('./test.pdf'));
}
}
此浏览器示例未在此处执行。其 load 处理程序会等待 iframe 文档加载完成后再调用 print()。该调用请求浏览器的打印界面;它不保证打印自动开始或完成。浏览器设置、PDF 查看器的行为和打印策略都可能影响结果,并且某些浏览器可能会阻止在异步加载后发出的打印请求。如果界面未打开,请检查该 URL 是否提供 PDF,并尝试用户可见的 PDF 链接或库集成。
在 JavaScript 中使用 Print.js 库打印 PDF 文件
Print.js 是为页面添加打印功能的库替代方案。其设置和 API 取决于您选择的版本,因此请使用 Print.js 文档 获取当前安装步骤和受支持的 PDF 打印选项。本文并非基于某一特定版本的文档,因此不指定 CDN URL 或特定于版本的函数调用。
与 iframe 方法一样,请确保浏览器能够访问 PDF 的 URL。查看库的文档,了解适用于您所选版本的任何访问限制和选项。该库可以请求打印,但浏览器和 PDF 查看器仍然控制打印界面,并且由用户完成打印操作。