PDF导出与打印预览:复用同一套模板的取舍

0 阅读1分钟

先给结论:打印预览和 PDF 导出,差在谁负责排版

打印预览和 PDF 导出看起来是同一个页面上的两个按钮,实际是两条责任链。

预览这条链是:模板 → DOM → 浏览器排版引擎 → 打印机驱动。分页由浏览器按纸张尺寸计算,字体用本机安装的那个,缺了就回退。用户点打印拿到什么,取决于他机器上装了什么。

导出这条链是:模板 → 你的渲染器 → PDF 文件。分页自己算,字体自己嵌,页码、跨页表头这些浏览器不会替你管。

这三点差异在 vue-print-designer 里是显式拆开的,仓库在 gitee.com/theGreatOld… 。

具体差在哪:

字体嵌不嵌。预览里写 font-family: SimSun,本机有就用。PDF 不嵌字体,换台机器打开就是方框或者替代字形。实测一份 12 页合同,正文用未嵌入的思源黑体,Windows 打开正常,macOS 打开后版面整体右移约 3mm,表格竖线错位。

分页谁算。浏览器只处理不切断行,其他不管。表格跨页重复表头、页脚页码递增、孤行控制,都是导出侧的事。

要不要矢量文字。预览是屏幕像素,看着清楚就行。PDF 给印刷或归档用,文字得是矢量,能选中能搜索。

共用一套模板省的是布局维护——列宽、字段绑定、样式层级写一遍两边都用。代价不在布局本身,在字体和分页各要写一次适配。省下来的是重复改样式的时间,花出去的是把分页规则显式化。

最小闭环,一份模板挂两个 render target:

import { createDesigner } from 'vue-print-designer'

const designer = createDesigner({
  template: contractTemplate,        // 同一份 DSL,只写一次
  targets: {
    print: { mode: 'dom' },          // 交给浏览器排版
    pdf:   { mode: 'render-tree',    // 自己算分页
             fonts: ['SourceHanSans'],
             paginate: true }
  }
})

await designer.render('print')            // 出打印 DOM,走 window.print()
const tree = await designer.render('pdf') // 出渲染树,交给 PDF 引擎

模板 DSL 只写一次,render('print') 出打印 DOM,render('pdf') 出带分页信息的渲染树;字体在 pdf target 里声明后由渲染器嵌入。预览和导出不分叉,分页规则也不用两边各写一遍。

财务 单据 打印

四条候选路线:从 window.print 到双渲染

四条路,选哪条看两件事:PDF 里的字要不要矢量,分页规则由谁负责。

A:打印 CSS + window.print。零依赖。纸张和页边距写 @page,表格跨页靠 thead 自动重复,段落加 break-inside: avoid 避免被切断。导出靠用户在打印对话框里点“另存为 PDF”。问题主要出在浏览器:@page 的页眉页脚 margin box,Chrome 到现在不支持,页码只能用打印对话框自带的,字号和位置都改不了。同一份模板在 Chrome 和 Safari 里分页位置能差出一行。

B:html2canvas + jsPDF。整页截成 canvas 塞进 PDF,半天跑通,所见即所得。代价是文字变成图片,选不中、搜不到,复制出来是空白。实测 300dpi 下 A4 单页 180–400ms,文件 1–3MB;二十页的合同轻松 20MB 往上,归档系统多半会拦截。中文小字号缩放后发虚,打印出来笔画粘连。

C:服务端 Puppeteer。字体装进容器,分页交给 page.pdf() 的 format、margin、headerTemplate。冷启动 800ms 起,常驻浏览器进程占 300–500MB 内存,并发一上来就得开进程池。镜像里要多装十几 MB 字体,装好一次就不用再管。适合后台批量出件,不适合用户点一下在那儿等两秒。

D:模板层统一 + 双渲染器。一套模板 DSL 挂两个 target:打印出 DOM 交给浏览器,PDF 出自己的渲染树、自己算分页。省的是布局维护:列宽、字段绑定、样式层级写一遍,两边都用。花出去的是分页规则得显式写出来,不能指望浏览器猜。

vue-print-designer 走的是 D。模板里给区块打锚点:repeat-header 标在表头,keep-with-next 标在标题和首行之间,孤行阈值写在块属性上。打印预览走 DOM,PDF 导出拿同一套锚点算渲染树,两边分页位置对得上。列宽改一次,预览和导出同步生效,不用两边各调一遍。这套锚点在 A 里由浏览器替你定,在 vue-print-designer 里则变成模板的一部分,能测、能回归:换一个分页引擎,锚点不用重写。

便利店 收银

对比表格:字体、分页、耗时、维护成本

先说结论:内部单据、量不大,用 A 就够;对外交付的 PDF 要归档、要检索,选 C 或 D;手上已经有模板资产,优先考虑 D——重写模板的成本,比换渲染器高得多。

实测口径:A4 单页、20 行表格、Chrome 120,数据在同一台机器上跑三遍取中位数。截图式指 html2canvas + jsPDF 那条链路,Puppeteer 分冷启动(容器刚拉起)和热渲染(浏览器进程常驻)两档。

方案字体处理分页控制文字是否矢量单页实测耗时首包体积维护成本
A print-js / window.print()跟随系统字体,客户端没装该字体就 fallback,中文字形不可控只有 @page 的 margin 生效,页眉页脚 margin box 至今不认;break-inside 能挡一部分,跨页位置靠浏览器自己判断是弹窗 <200ms打印库十来 KB低,但只覆盖打印一半,导出得另起一套
B html2canvas + jsPDF把 CSS 字体画进 canvas,中文小字号缩放后笔画粘连按 canvas 像素高度硬切,切点落在哪一行算什么,表头重复要手动补否,选不中、搜不到、复制为空白300dpi 下 180–400ms两个库 500KB 量级中,出问题基本靠调 scale 猜
C 服务端 Puppeteer字体装进镜像,可控;漏装一个就静默 fallbackpage.pdf() 的 format / margin / headerTemplate,规则完整可写是冷启动 800ms+,热渲染 250ms 左右前端 0;镜像多十几 MB 字体,常驻进程 300–500MB 内存中高,进程池、字体、Chromium 版本三处都要盯
D vue-print-designer 双渲染器字体栈写在模板里,预览和导出读同一份,PDF 侧嵌入字体锚点 + 规则配置化,见下方示例是预览即时,导出与 C 热渲染同量级渲染器按需加载,点导出才拉中低,布局只写一遍,规则可测

A 那一行最省事,也最没辙。同一份模板在 Chrome 和 Safari 里分页能差出一行,你连在哪儿改都不知道,因为那是引擎的排版结果,不是你写的。B 半天能跑通,二十页合同出来 20MB 往上,归档系统直接拦。

D 的维护成本低在哪儿,看这段模板配置:

{
  block: 'items-table',
  repeatHeader: true,   // 跨页重复表头
  keepWithNext: true,   // 标题不落单在页尾
  orphans: 2,
  widows: 2
}

这段规则在预览和导出时各执行一次,输入是同一棵模板树,分页位置对得上。改列宽只改一处,两边同步生效。代价是这些规则你得显式写出来——A 里由浏览器替你决定,D 里变成模板的一部分,能回放、能回归:改完跑一遍用例,比一遍分页位置,动了哪页一眼看得见。换渲染引擎时锚点不用重写,这是当初这么设计的理由。