CSS打印样式:表头跨页重复与断行实测

0 阅读1分钟

先给结论: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 / 80 / 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 126Firefox 127Safari 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>

三种写法:

  1. 不写任何规则。行从中间被切断,第 2 页顶部没有表头。
  2. 只在 tr 上加 break-inside: avoid。行保住了,但表头仍不重复。
  3. 写到 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 双声明,不需要你手写。要覆盖,在打印样式面板写同名选择器,优先级高于生成样式。