Odoo 9 Qweb报表问题：避免表格行跨页及表头重复异常

我在处理Odoo 9的Qweb报表开发时，经常碰到这两个问题，以下是经过实践验证的解决方法：

问题1：防止表格行被拆分到两页 #

要避免表格行跨页拆分，核心是利用CSS的page-break-inside属性，结合Odoo的Qweb渲染机制来实现：

• 第一步，在报表的CSS区块添加自定义样式：

/* 禁止表格行跨页拆分 */
.no-break-row {
    page-break-inside: avoid !important;
    -webkit-page-break-inside: avoid !important;
}

注意：加上-webkit-page-break-inside是为了兼容wkhtmltopdf（Odoo默认的PDF渲染工具）的webkit内核。

• 第二步，在Qweb模板的表格行标签中绑定这个类：

<tr t-att-class="'no-break-row'">
    <!-- 你的单元格内容 -->
</tr>

• 额外提醒：确保表格本身没有设置page-break-inside: auto这类会覆盖上述样式的属性，否则可能失效。

问题2：修复跨页后表头与表格内容重叠的问题 #

Odoo默认支持<thead>重复渲染，但有时候会因为页面边距、CSS冲突或wkhtmltopdf的特性导致重叠，解决步骤如下：

1. 确保表格结构与基础样式正确
   首先确认你的表格使用标准的<thead>和<tbody>结构，然后添加以下CSS：

table {
    border-collapse: collapse; /* 避免边框断裂 */
}
table thead {
    display: table-header-group;
    page-break-inside: avoid;
}
table tbody {
    display: table-row-group;
}

2. 调整页面边距
   很多时候重叠是因为页面底部边距太小，导致表格内容挤到下一页表头区域。你可以在报表模板开头设置自定义纸张格式：

<t t-set="paperformat" t-value="{'margin-top': 15, 'margin-bottom': 20, 'margin-left': 15, 'margin-right': 15}"/>

单位是毫米，你可以根据实际报表内容调整数值。

3. 添加表头间距
   如果还是有轻微重叠，可以给表头添加一个底部空白伪元素，拉开和下方内容的距离：

table thead tr:last-child:after {
    content: "";
    display: block;
    height: 8px;
    visibility: hidden;
}

4. 排查冲突样式
   检查是否有自定义的page-break-after或page-break-before属性应用在表格或行上，比如不要给<tbody>的行设置page-break-after: always，这会强制分页导致不必要的重叠。

内容的提问来源于stack exchange，提问作者Fares Izem