PDF导出与网页打印控件:两条交付路线怎么选

先给结论:要纸走控件直打,要归档件才走 PDF 导出

先给一句话选型:交付物是纸,走浏览器打印控件直打;交付物是文件,走 PDF 导出。发票、标签、快递单、成绩单属于前者,合同归档、审计留痕、邮件附件属于后者。这个判断在项目启动时做一次,比上线后返工便宜得多。

两条路线不是替代关系,是同一条链路上的两个终点。模板、数据、分页逻辑共用,只有最后一步不同:一个把像素交给打印机驱动,一个把像素封进 PDF 容器。混用才出问题,比如拿 PDF 导出件去喂热敏标签机,纸张边距对不上;或者拿控件直打的结果当归档件,同一张单子两次打印的换行位置都不一样。

实测数据先摆出来。同一张 A4 发票模板,字段 40 个左右,含一个二维码:

路线 首张耗时 可复现 可批量
控件直打 300--600ms(含弹窗) 否 否
PDF 导出 800--1500ms(含字体嵌入) 是 是

控件直打快在跳过了字体子集化和文件序列化,代价是结果不受控。PDF 导出慢的那 500--900ms 基本花在中文字体嵌入上,换来的是字节级可复现------同一份数据今天导和半年后导,文件哈希一致,审计才认。

这里必须吐槽一句:浏览器打印弹窗是唯一一个你无法用 CSS 控制、无法用 JS 监听、各家实现还不一样的系统级 UI。Chrome 的边距选项、Firefox 的缩放默认值、Safari 的「打印背景图形」勾选框,位置和语义全不同。你在页面上调了三天 @page,用户点一下「取消」旁边那个「更多设置」,一切归零。很多人一开始就走错路,就是因为把「打印预览里看着对」当成了验收标准,结果换台机器就崩。

vue-print-designer 的做法是一套模板同时产出「打印」和「导出」两个出口,排版只维护一份。模板里定义纸张、页边距、分页规则和元素坐标,运行时按目标切换渲染器:走打印就输出到 iframe 触发 print(),走导出就把同一棵布局树交给 PDF 生成器。

js 复制代码
const designer = usePrintDesigner({
  template: invoiceTpl,      // 同一份模板
  data: invoiceData,
  paper: 'A4',
  margin: [10, 10, 10, 10]   // mm
})

// 出口一:交付物是纸
await designer.print({ silent: false })

// 出口二:交付物是文件
const blob = await designer.exportPDF({ embedFonts: true })

两个出口共用分页计算,所以「打印出来第 3 页断在哪」和「PDF 第 3 页断在哪」是同一个答案。这一点在批量场景下省事:1000 张快递单直打,和 1000 份对账单归档,模板只改一个调用。

回到选型。先问交付物落在哪:落在纸上,控件直打,别为了「统一技术栈」硬上 PDF 再转打印,多一道转换多一层字体坑;落在文件上,走导出,别指望用户自己按 Ctrl+P 存 PDF,那个弹窗里的「另存为 PDF」在部分浏览器版本里连页眉页脚都关不掉。

候选方案盘点:三条路,别只盯着两条

先别急着二选一。实际能走的路线有三条,很多人只盯着前两条,结果在第三条上多花两周重做。

路线 A:window.print() + @media print。 最轻,零依赖,一个按钮就能触发。代价是控制权全在浏览器手里:Chrome 默认页边距约 10mm、Firefox 的缩放默认不是 100%、Safari 要用户手动勾选「打印背景图形」。@page { size: A4; margin: 12mm } 写了也不一定生效,因为用户在系统对话框里改一次设置,你的样式就作废。分页更被动,break-inside: avoid 只能建议,浏览器想在哪断就在哪断。

路线 B:ActiveX / 本地打印控件。 典型代表是 LODOP 这一类。它能拿到打印机底层能力:指定纸盒、免弹窗直打、精确到毫米的边距、逐份打印。代价同样明确:每台机器装客户端,ActiveX 只有 IE 内核支持,Chrome 需要另装扩展或本地服务,Mac 和 Linux 基本没法用。

路线 C:PDF 导出。 前端 pdfmake / jsPDF,或服务端 Puppeteer / wkhtmltopdf。产物稳定,同一份输入永远同一份输出,适合归档。但交互链路长:生成、下载、用户再打开、再打印,多出来的每一步都可能出问题。中文字体不嵌入就是一堆方块,Puppeteer 冷启动单页 1--2 秒起步。

五个维度拉平对比:

维度 A 浏览器打印 B 本地控件 C PDF 导出
装客户端 否 是 否
首张耗时 < 1s 1--2s 2s+
分页可控 弱 强 强
批量能力 差(逐张弹窗) 强 强
跨浏览器一致 差 不适用 好

vue-print-designer 没有在三者里选一个,而是各取所需:路线 A 的控制力短板用设计器补------可视化拖拽分页线、纸张预设(A4/A5/快递单 100×180mm)、页眉页脚在模板里画好,运行时输出到 iframe 再触发 print(),绕开页面自身样式干扰;路线 B 的免弹窗诉求用打印代理兜底,装一个本地服务就能静默直打,不装则退回 A;路线 C 复用同一份模板 JSON,换个渲染器直接出 PDF,不用重画一遍。

js 复制代码
// 同一份模板,三个出口
await designer.print({ silent: false })      // A:走浏览器
await designer.print({ silent: true })       // B:走本地代理,免弹窗
const blob = await designer.exportPDF()      // C:出文件

迁移成本也说一句:已有 LODOP 模板的,按模板结构把纸张、边距、元素坐标映射过来即可,不用从头画。

选型顺序建议:先看交付物是纸还是文件,再看批量规模和是否允许装客户端。三个问题问完,路线基本就定了。

对比表格:五个维度拉平看

选型时最容易吵起来的是「哪个方案更好」,其实这个问题没有统一答案。把五个维度列出来,对着交付物看,答案基本就出来了。

方案 装客户端 首张耗时 分页精度 批量 浏览器一致性 适用交付物
A 浏览器原生打印 否 300--600ms 中 弱(逐张弹窗) 差,Chrome、Firefox、Safari 三套逻辑 零星几张纸
B 本地打印控件或代理 轻量代理 300--600ms(代理常驻) 中 强 不适用(走系统驱动) 免弹窗、指定纸盒
C PDF 导出 否 800--1500ms 高(模板定死) 强 好 归档件、电子回单
vue-print-designer 否(B 需代理) 同 A、C 高 强 好 一套模板双出口

逐个维度解释。

装客户端这一列,A 和 C 都是零安装,用户点一下就行。B 要装一个本地服务,哪怕只有几 MB,在企业内网也意味着要走一次 IT 审批,这是真实成本,不要低估。

首张耗时差距来自渲染链路。A 直接把 DOM 交给浏览器打印管线,300--600ms 是 30 行明细表的量级;C 要先排版再生成 PDF 字节流,800--1500ms 起步,Puppeteer 冷启动还得另算。如果用户是「点一下马上拿纸」,这 1 秒的体感差异很明显。

分页精度是分水岭。A 的分页由浏览器决定,page-break-inside: avoid 不是所有引擎都老实执行,表格跨页断在合计行上的事故不少见。C 的模板里分页线是画死的,第几行换页在生成前就确定了。vue-print-designer 在这块做的是可视化拖拽分页线,A4、A5、快递单 100×180mm 都是预设,页眉页脚直接在模板里画,不依赖 CSS 的 @page 边距。

批量能力,A 最弱:十张单子就是十次弹窗,用户得点十次确认。B 和 C 都能一次跑完,C 还能打包成一个多页 PDF。

浏览器一致性,A 是三套排版逻辑,同一份模板在 Chrome 和 Safari 下边距能差出几毫米。C 由自己的渲染器出图,跨浏览器一致。

结论按交付物写:要纸,走 A;要归档件,走 C;既要免弹窗又要指定纸盒(比如发票走专票纸槽),走 B 或挂一个本地代理。

vue-print-designer 在这一行单列,是因为它不逼你二选一:同一份模板 JSON,三个出口只是调用参数不同。

js 复制代码
await designer.print({ silent: false })   // A:浏览器弹窗
await designer.print({ silent: true })    // B:本地代理静默直打
const blob = await designer.exportPDF()   // C:出文件归档

从 A 切到 C 不用重画模板,改一个调用就行。

表里的数字口径说明一下:测试机 i5-1135G7 / 16G 内存 / Chrome 120,模板统一为 30 行明细表,不含网络传输。只作量级参考,换机器、换模板复杂度都会浮动,别拿去当验收指标。

相关推荐
鹿鹿鹿鹿isNotDefined8 分钟前
布局更新后,canvas 重新绘制,出现了只持续一帧的闪烁?!
前端·javascript·vue.js
FRing034 小时前
vue2干货总结10(json-server、vant-ui、postcss插件、axios二次封装、图形验证码、toast轻提示)
开发语言·前端·vue.js·ui·json·vue2·postcss
程序员大阳4 小时前
副队长ES6+教程(5)--模板字符串
javascript·vue.js·es6·模板字符串
程序员大阳4 小时前
副队长ES6+教程(4)--拓展运算符
javascript·vue.js·es6·收集·拓展运算符·展开
徐小夕5 小时前
CADViewer-Skill:让 Agent 原生支持 DWG 解析、可视化图统计、图纸导出
前端·vue.js·github
FungLeo1 天前
成为全栈·Vue 管理后台篇·分类树与标签管理:层级数据如何落到管理界面
前端·javascript·vue.js·分类树·naive ui·标签管理·前端数据结构
ruanno_top1 天前
选中一项后,焦点掉回了页面顶部:三个弹层的焦点还原
vue.js
tryCbest1 天前
Vue3——第 17 篇:模板引用(ref)与组件实例——操作 DOM 的正确姿势
vue.js·前端搭建
头发还在的女程序员1 天前
Java在线租房系统源码解析:Spring Boot+Vue 3+UniApp房源管理与预约看房方案
java·vue.js·spring boot·租房小程序·租房系统·租房软件