先给结论:90% 的报表跨页丢表头,两条 CSS 规则就够了
先给结论:长报表跨页时表头丢失、行被拦腰截断,90% 的情况靠两条 CSS 规则就能解决。代码在下面,可以直接复制到打印样式表里:
@media print {
/* 1. 表头每页重复 */
thead { display: table-header-group; }
/* 2. 行不被切断 */
tr { break-inside: avoid; page-break-inside: avoid; }
/* 3. 兜底:给页面留出上边距,别让内容顶到纸边 */
@page { margin: 12mm 10mm; }
}
第一条规则管表头重复。thead 默认就是 table-header-group,但不少重置样式、UI 框架的表格组件会把它改成 block 或 table-row,一旦改掉,Chrome 就不再在每页重绘表头。显式写回来,等于把这条行为固定住。
第二条规则管行不被切断。浏览器默认允许在 tr 内部换页,一行高一点、内容多一点,就会出现上半行在第 3 页、下半行在第 4 页的情况。break-inside: avoid 让整行作为一个整体移动,page-break-inside 是给老内核的兼容写法,两个一起写不亏。
第三条是保底措施,很多人会漏。@page 不设 margin 时,浏览器用默认页边距,某些版本下第一页的表头会被压到纸张边缘外,看起来像“表头没重复”,其实是画到纸外面去了。
实测数据。同一张采购订单报表,38 行明细,A4 纵向,Chrome 126,导出 8 页:
| 指标 | 加规则前 | 加规则后 |
|---|---|---|
| 无表头的页数 | 7 / 8 | 0 / 8 |
| 行被切断处 | 7 处 | 1 处 |
| 表头压边 | 1 页 | 0 页 |
剩下那 1 处异常出在嵌套表格里:外层 tr 里套了一个明细小表,break-inside: avoid 只作用于外层行,内层小表的行仍然会被切开。这种情况得给内层表格单独加规则,或者干脆把嵌套结构拆平。
还有个坑得说清楚:Chrome 对 thead 的默认行为并不总是生效,尤其是表格用 display: block 做过横向滚动容器之后,thead 的 table-header-group 会被继承链打断。所以别指望“默认应该会重复”,该写的显式写上。
Safari 更别指望。break-inside: avoid 在 tr 上的支持历史上反复横跳,某几个版本认 page-break-inside,某几个版本两个都不认,还有版本只在 tbody 上生效。一套样式通吃所有浏览器是不现实的,能覆盖主流的 Chrome 和 Edge 打印链路,剩下的用 PDF 导出兜底。
在 vue-print-designer 里,这三条规则已经写进打印样式层的默认模板,新建设计器模板时不用从零写 CSS,表格组件拖进去就带着表头重复和断行保护。项目地址 gitee.com/theGreatOld…
底层机制:分页是浏览器的事,你只能通过盒模型与分页属性跟它协商
先给结论:打印分页切在哪,你决定不了,只能通过盒模型和分页属性去跟浏览器协商。
打印走的是另一条渲染管线:DOM 先按打印介质重建成打印盒树,再按 @page 定义的页面区域切片。切片点是浏览器内部算出来的,CSS 里没有“从这里断”这种指令。你能表达的意思只有三种:哪些盒子必须完整、哪些盒子前后要断开、哪些盒子每页都要出现。
@media print {
table { display: table; } /* 别在这一层改成 block */
thead { display: table-header-group; }
tfoot { display: table-footer-group; }
tr { break-inside: avoid; page-break-inside: avoid; }
}
关键在 display。thead/tfoot 的盒类型是 table-row-group,只有 display 为 table-header-group 时才参与跨页重复;一旦被改成 block 或 flex(比如为了做横向滚动容器),它就退化成普通行组,只画一次。反过来给 tbody 写 table-header-group 是常见误配:它确实会重复,但重复的是数据行,你会看到第一行明细在每页顶上重播。
break-inside / break-before / break-after 出自 CSS Fragmentation 规范,page-break-* 是它的旧别名。新代码写 break-*,但老引擎只认旧名,两个都写成本几乎为零。
break-inside: avoid 失效的场景我踩过四个:元素自身高度超过一页(只能断);祖先 overflow 不是 visible,裁剪上下文会干扰分片;嵌套表格中外层 tr 的 avoid 管不到内层表的行;tr 上挂了 transform 或参与 flex 重排。
实测清单,38 行明细的采购订单报表,A4 纵向:
| 规则 | Chrome 126 | Firefox 127 | Safari 17 |
|---|---|---|---|
| thead 声明 table-header-group 后跨页重复 | 生效 | 生效 | 生效 |
| table 改成 block 后仍重复 | 失效 | 生效 | 失效 |
| tr 上 break-inside: avoid | 生效 | 生效 | 部分失效 |
| tr 上 page-break-inside: avoid | 生效 | 生效 | 生效 |
| 行高超过一页时 avoid | 失效 | 失效 | 失效 |
| 嵌套表内层 tr 的 avoid | 失效 | 失效 | 失效 |
按这张表,写法就定了:thead 显式声明不省,tr 新旧属性并列,Safari 靠旧名兜。在 vue-print-designer 里这几条是编译期处理的——表格组件拖进画布就带默认打印样式,属性面板勾“行不跨页断行”,输出的是 break-inside 加 page-break-inside 的双声明,不需要你记得给 thead 补 display。要自己接管,在打印样式面板覆盖同名选择器即可,你的声明优先级更高。
源码佐证:规范怎么写的,浏览器怎么做的
规范原文不绕弯。CSS Fragmentation Level 3 对 break-inside: avoid 的定义是:只要盒子能完整放进一个分片,就不要把它拆开。注意前提是“能放进”——行高超过一页,浏览器没有别的选择,只能断。CSS Tables 规范里,table-header-group 在分页时会在每个分片顶部重复绘制,但限定在块级表格上下文中:表格的 display 得是 table,表头得是 table-header-group。
写个最小页面能直接看出差别。复制成 demo.html,用 Chrome 打印预览:
<table style="width:100%;border-collapse:collapse">
<thead>
<tr><th>SKU</th><th>数量</th><th>单价</th></tr>
</thead>
<tbody>
<!-- 40 行,每行 56px 高,A4 纵向必然跨页 -->
<tr><td>A-001</td><td>12</td><td>38.00</td></tr>
<!-- ... -->
</tbody>
</table>
三种写法:
- 不写任何规则。行从中间被切断,第 2 页顶部没有表头。
- 只在
tr上加break-inside: avoid。行保住了,但表头仍不重复。 - 写到
td上。Chrome 126 里效果等于写在tr上,因为分片的最小单位是行盒;但 Safari 17 会忽略一部分,需要同时写page-break-inside: avoid。
实际要两条规则一起上:
thead { display: table-header-group; }
tbody tr { break-inside: avoid; page-break-inside: avoid; }
表头重复靠 thead 的盒类型,行不切断靠 tr 的 avoid,两者互不替代。
源码里最常见的两个错误,都是把表格语义改掉了。
一是给 thead 加 position: fixed。元素脱离表格布局,浏览器不再把它当 table-header-group 绘制,跨页重复直接失效。想让表头在屏幕上吸顶,用 position: sticky 并且只作用于屏幕媒体,打印媒体里还原成 static。
二是给 tr 加 display: flex。盒类型从 table-row 变成 flex 容器,break-inside 的分片行为跟着变,Safari 上还会把列宽算错。用 flex 排版表格行的工具类,在 @media print 里必须撤回。
vue-print-designer 的模板输出是标准 table 结构:拖进画布的表格组件导出 thead、tbody、tr、td 原样保留,不会用 flex/grid 重构布局,所以 table-header-group 的重复绘制前提天然成立。属性面板勾“行不跨页断行”,编译时输出的是 break-inside 加 page-break-inside 双声明,不需要你手写。要覆盖,在打印样式面板写同名选择器,优先级高于生成样式。