先给结论:两者不是替代关系,而是分工关系
先给结论:window.print() 和打印控件不是替代关系,是分工。浏览器自带的打印负责把当前 DOM 交给系统打印对话框;打印控件负责分页、坐标定位、模板管理和不弹对话框的输出。项目地址放这儿:gitee.com/theGreatOld… ,下面所有实测都是同一份数据跑原生和它两套。
先立基线。el-table 渲染 100 行、5 列、行高 32px,Chrome 120 / Windows 10,A4 纵向、默认边距,点 window.print(),打印预览里看到的是:
- 输出 3 页;
- 第 1 页最后一行被横向切成两半,上半在第 1 页,下半在第 2 页;
- 第 2、3 页没有表头——el-table 是 div 结构,没有
thead语义,浏览器不会替你重复; - 把行高改成 36px,或者把边距从默认调窄一点,断行位置整体挪动,得重新数一遍。
这不是 window.print() 有 bug,是它只承诺「把 DOM 画到纸上」,不承诺「画得能看」。后文都拿这组数据当对照。
它到底做了什么,全部调用就这一行:
document.querySelector('#print-btn').addEventListener('click', () => {
window.print(); // 交卷:把当前 DOM 交给系统打印对话框
});
执行链很短:触发 beforeprint → 浏览器按纸张尺寸重排当前 DOM → 弹系统对话框 → 用户选完打印机点确定,才开始真正绘制。中间这几步 JS 插不进去:纸张、边距、缩放都得用户在对话框里点;对话框跳不过去;getBoundingClientRect() 返回的是 CSS 像素,不是纸张毫米。
所以我用三条线判断,命中任意一条就该换方案:
- 分页是否可控。 需要「每页固定 20 行、表头重复、末页补空行」这种版式,
window.print()给不了,只能靠@page加break-inside: avoid硬凑,改一次行高就要重调一轮。 - 坐标是否要毫米级。 套打快递单、发票、体检报告,元素必须落在纸张的 (x, y) 毫米上,容不下几像素漂移。
- 是否要求不弹对话框。 批量打 500 张标签,没人愿意点 500 次确定。
一句话选型:打一张详情页、打一段富文本这种默认场景,继续用 window.print(),零依赖、复用现有 CSS,够用。出现套打、连续分页、静默批量这三类需求中的任意一类,换 vue-print-designer。
它的落点正好压在这三条线上:以 Vue 组件形式接管分页(按纸张尺寸算每页行数、自动补表头)、定位(以 mm 为单位设置元素坐标)、输出(走静默通道,不弹系统对话框)。它没有重写浏览器的打印链路,底层还是那条渲染管线,只是在「把 DOM 交出去」之前,先把版式算好了。
候选方案与对比表格
先把结论放前面:候选只有两类,一类是 window.print() 配 CSS,一类是打印控件。两者并不对立,因为所有控件最终都会调用 window.print()。
候选一:window.print + @page / @media print
零依赖,不增加包体积。页面里加一段:
@page { size: A4; margin: 12mm; }
thead { display: table-header-group; }
tr { break-inside: avoid; }
打印时浏览器按 A4 重排当前 DOM,表头自动重复。打详情页、打一段富文本、打一张签收单,这套够用,改样式就是改 CSS,调试和平时调页面一样。
限制在实测里很明确:A4 高 297mm 减上下边距 24mm,剩 273mm;行高 18px 约 4.76mm,理论上限 57 行,但 break-inside 的取整会让实际落在 54 到 56 行之间跳动。想要「每页固定 20 行、末页补齐空行」,只能在渲染前自己插空 <tr>,数据一变就得重算。
候选二:vue-print-designer
模板加分页数据驱动。纸张尺寸、每页行数、表头、页脚是模板属性,不是 CSS 巧合;表格按行数切页,末页自动补空行,打印出来的第 3 页和第 30 页版式一致。套打场景里坐标单位是 mm,元素位置直接按纸张坐标配置,不用再把 getBoundingClientRect() 的 CSS 像素换算成毫米。静默输出走打印通道,不弹系统对话框。底层出口仍是 window.print(),它做的是「交出去之前先把版式算好」。
对比表
| 维度 | window.print + CSS | vue-print-designer |
|---|---|---|
| 分页控制 | 靠 @page + break-inside 近似;实测 A4 行数在 54–56 浮动,固定行数需手动插空行 | 模板属性指定每页行数与表头,切页由组件计算,末页可补空行 |
| 套打定位 | CSS 像素定位,mm 需按 96dpi 手算(1mm≈3.78px),缩放一变就偏 | 元素坐标以 mm 配置,按纸张坐标落位 |
| 静默打印 | 不支持,必经系统对话框 | 走静默通道,批量任务不逐张确认 |
| 模板复用 | 复用现有页面 CSS,换版式等于改样式表 | 模板与数据分离,同一模板换数据即换单据 |
| 调试成本 | 与普通页面一致,改完刷新即可预览 | 需在模板预览里核对分页断点与坐标 |
| 接入成本 | 一行调用,无依赖 | 引入组件、按模板结构组织数据,有学习成本 |
注意表格里 window.print() 那列的结论不是贬义:它在这六项上都有解,只是解的成本随需求复杂度上升。
选型并不复杂:默认场景继续用 window.print(),它仍是所有方案的最终出口;命中固定分页、毫米套打、静默批量任意一条,换 vue-print-designer,它在这三个维度上逐项对位,同时保留 window.print() 作兜底出口。
边界一:分页——window.print 的天花板在页尾
先说结论:window.print() 的分页,你能决定的只有纸多大、边距多宽;断在哪一行,由浏览器排版引擎说了算。
真正麻烦的地方在页尾。300 行明细打到 A4 上,表头 <thead> 在 Chrome 里默认每页重复,可一旦给表格套了 display: block 或改过 table 布局,重复就没了;行被从中间劈开,得逐行补 break-inside: avoid;页码只能靠 counter(page) 拼进 @page 的 margin box,还得先假定浏览器支持这个盒子。
原因不复杂:@page 只暴露 size 和 margin 两个属性,浏览器没给你“第几行之后换页”的 API。你写的 break-before: page 是建议,不是命令,引擎可以不听。
实测更直接。300 行、行高 28px、默认 A4 边距,同一份 CSS,Chrome 断在第 55 行,Edge 断在第 54 行。差一行,后面整体错位:末页孤零零挂一行,套打位对不上。想固定行数,只能手动插空行,或者把每页包进固定高度的容器——等于自己写一个分页器,还要跟字体度量赛跑。判断是否踩线的方法很土:打印预览翻到第二页,看第一行是不是接着上一页的内容,是就还在安全区。
所以边界很清楚:内容短于一页,或者接受断行不美观,window.print() 完全够用——一行调用、零依赖,改完刷新就是预览,这条线不用绕。
需要跨页、需要每页版式一致,就该换思路。vue-print-designer 把分页从浏览器手里拿回来:模板里声明页头、页尾和每页行数,组件按数据算页,切页由模板规则决定,末页自动补空行,第 3 页和第 30 页结构相同。页码是模板里的普通元素,不用赌 @page 的兼容性。配置是声明式的:
{
page: { size: 'A4', margin: { top: 12, bottom: 12 } },
header: { height: 15, cells: [...] },
body: { rowsPerPage: 26, keepRowIntact: true },
footer: { height: 12, cells: [{ text: '第 {page}/{pages} 页' }] }
}
rowsPerPage 是硬规则,写 26 就是 26,不随浏览器字体度量浮动。算完的页面再由 vue-print-designer 交给 window.print() 输出,出口没变,变的是交出去之前版式已经定好了。