浏览器端生成 PDF:print 方案与分页控制的实战取舍

0 阅读2分钟

「帮页面加个导出 PDF」——这个需求十有八九被理解成「加个按钮调 window.print」。能跑,但离「能用」差着一组分页控制的细节。

print 方案的工程化清单

第一步:打印样式隔离。@media print 里重置一切屏幕样式:去背景图、去固定定位(header/footer 的 fixed 元素会重复出现在每一页)、配色改打印友好。用 print-color-adjust: exact 保住必须保留的品牌色。

第二步:分页控制三件套。

  • break-inside: avoid 加在卡片、表格行、图文块上——防内容被拦腰切断,这是导出 PDF 投诉的头号来源;
  • break-before: page 加在章节标题上——每个大章节从新页开始;
  • 表格用 thead + 浏览器的跨页表头重复——display: table 语义化表格自动跨页带表头,div 模拟表格没有这个能力。

**第三步:页眉页脚与页码。**浏览器打印引擎的页眉页脚默认带 URL 和日期,丑且不可控,用 @page { margin: 0 } 配合自己绘制的固定定位页脚(在打印媒体下显示)。页码在纯 CSS 里拿不到,需要打印前用 JS 计算分页(测量每块内容高度模拟分页),或者接受「无页码」——业务上多数导出场景其实不需要页码。

print 方案的天花板

三个场景该换方案:需要精确到毫米的版式(合同、票据——print 的分页由浏览器引擎决定,毫秒级排版不可控);需要服务端批量生成(print 只能逐台机器手动点);需要一致的跨平台输出(同一页面 Chrome 和 Safari 打印结果有差异)。

换方案的方向:服务端走无头浏览器渲染 print(保留前端样式资产,分页同样受限于打印引擎)或结构化 PDF 库直接绘制(版式全可控,前端样式资产作废)。决策依据只有一条:版式的「像素级」要求是不是硬指标——是,直接上结构化库;不是,print 方案的维护成本最低。

实战小结

print 方案的正确打开方式是一份 checklist:print 样式重置、三件套分页控制、隐藏管理类元素(按钮、侧栏)、打印前弹窗提示「导出中」。这份清单跑下来,多数「导出 PDF」需求能在半天内交付到可用级别——先别急着否定它。