先给结论:打印样式错乱,90% 是 @page 和页眉页脚没对齐
打印出来的报表错位,多数时候原因不在表格,而在 @page。网页上看着对齐了,点打印后右列被切掉、最后一行跑进页脚,来回检查 CSS 也找不出问题。按下面的顺序排查,八成能在十分钟内定位。
先给排查顺序,省得乱试:
- 关掉浏览器自带的页眉页脚;
- 定
@page的 size 和 margin; - 最后才调表格分页、字号、行高。
反过来做基本白费功夫:你花时间把字号从 12px 调到 11.5px,想挤出那一行,结果页眉页脚还开着,上下各占一块,怎么调都差一截。
先看第一层。屏幕 CSS 直接搬到打印上下文,就会出问题。height: 100vh、position: fixed、overflow: hidden、box-shadow,在纸上全都不成立。100vh 是按视口算的,纸没有视口;fixed 元素在 Chrome 里会被重复画到每一页,或者干脆掉页。所以得单独放一段 @media print,把不该出现的隐藏掉,而不是指望屏幕样式自动适配。
第二层更隐蔽:@page 边距和打印机的物理不可打印区发生冲突。A4 是 210×297mm,多数喷墨/激光打印机四边各有 3–5mm 进不去纸。你写 margin: 0,浏览器不会报错,只是把内容顶到纸边,然后裁掉。安全做法是四边至少留 10mm。
第三层是浏览器页眉页脚。这一层最容易吃时间。实测基线:Chrome 的打印对话框里,页眉页脚默认开启,上下各吃掉约 12mm。297 − 24 = 273mm 可用高度。一份 20 行的报表,行高按 13mm 算,需要 260mm,加表头就顶到边界,实际打出来必掉 1 行。关掉页眉页脚后,可用高度回到 273mm 起步,同样内容能完整落下。
关掉之后,@page 才有意义:
@page {
size: A4 portrait;
margin: 10mm 10mm 12mm; /* 上 右左 下,下边略大留给页码 */
}
@media print {
body { margin: 0; }
.no-print { display: none; }
table { page-break-inside: auto; }
tr { page-break-inside: avoid; }
}
注意 margin 写在 @page 里,不是写在 body 上。写到 body 上等于在可打印区里再缩一圈,两边的留白会叠加,你会看到内容整体往中间挤。
手写 @page 的麻烦在于每次都要改代码、刷新、重开打印预览,试错成本高。项目 gitee.com/theGreatOld… 里的页面设置面板,就是把 paper / size / margin / orientation 直接暴露成可调项,拖动边距时预览同步变化,省掉改一次看一次的过程。vue-print-designer 内置的这套参数最终也落到同一段 @page 规则上,等于把上面那段 CSS 变成可视化的四个输入框。
顺序别乱:先把浏览器页眉页脚关掉,再定纸张和边距,最后动分页和字号。前两步没定,后面全是无效调整。
问题一:@page margin 设了没生效,谁在覆盖
现象很常见:代码里明明写了 @page { margin: 10mm },打印预览里四边还是 1 英寸左右的白边,改数字刷新也没反应。先别怀疑语法,多数情况是被别的规则盖住了,或者根本没进 print 上下文。
先确认生效与否。打开 DevTools(F12),按 Esc 调出抽屉面板,切到 Rendering,勾上 Emulate CSS media type,选 print。这时候页面会按打印样式重排,@media print 里的规则全部激活。再选中 html 节点,在 Styles 里搜 @page,看这条规则是亮着还是被划掉。被划掉就说明有更高优先级的东西在抢;搜不到,就是规则压根没命中,往下看两条。
第一条,@page 写在了 @media print 外面。这本身不算错,Chrome 认这种写法,但一旦外层还有别的媒体查询把整段包错了层级,比如误写成 @media screen { @page { ... } },打印时就完全不生效。稳妥做法是把它单独放,别嵌套在别的媒体查询里:
/* 单独成段,不要嵌在 @media screen 里 */
@page {
size: A4 portrait;
margin: 10mm 10mm 12mm;
}
@media print {
html, body {
margin: 0;
padding: 0;
}
/* 容器也不要留 padding,否则又是双重边距 */
.report-wrap {
padding: 0;
}
}
第二条,打印机驱动自己的边距优先。浏览器默认对话框里有一项「边距」,选的是「默认」时,驱动会按自身最小可打印区来裁,常见 4–6mm,部分激光机到 8mm。你在 CSS 里写 margin: 0,出纸还是留白,就是这个原因。实测时把对话框边距切成「无」,再对比一次,能立刻分清是 CSS 没生效还是驱动在兜底。
还有一类是双重边距叠加。@page margin: 10mm 给的是纸张到内容区的距离,如果 body 上还留着 margin: 8px(浏览器默认值)或者某个容器有 padding: 16px,这圈留白会在 10mm 内部再缩一次,最终视觉边距变成 10mm 加上那几毫米。所以 @page 和容器重置必须成对出现,只做一半等于没调。
确认顺序建议这样:先在 DevTools 里 emulate 成 print,看 @page 是否命中、body margin 是否为零;再打开打印对话框,把边距选「无」跑一遍;最后才动 size 和分页。
手写这套东西的麻烦在于它散落在两个地方:@page 一段、容器重置一段,改完还得手动同步。vue-print-designer 的页面设置面板把纸张、方向、四边距做成输入框,改完直接生成对应的 @page 与容器重置样式,不用自己记哪几处要一起改。它的模板配置里这两个部分是成组输出的,漏写容器重置这种情况基本不会出现。
按上面的顺序走一遍,如果 emulate 下 @page 命中了、对话框边距也选了「无」,出纸边距还是不动,那才需要去看是不是驱动强制了最小边距。