如何实现表格两单元格始终同页且避免页面留白？

我完全懂你遇到的痛点——之前给表格设置keep together后，只要标题加内容塞不下当前页，整个表格就直接跳到下一页，导致当前页留一大片空白，太浪费空间了。而你要的是标题和内容必须死死绑定在同一页，只有当内容本身太长的时候，才允许拆分内容部分，对吧？

问题根源 #

原来的keep together是把整个表格（标题+所有内容）当成一个不可拆分的整体，所以只要当前页容不下整个表格，就会直接把整个块移到下一页，留白就这么产生了。我们需要的是「标题和内容起始部分绑定，内容本身可分页」的逻辑。

实现代码（以iText为例） #

核心思路是用setKeepWithNext(true)把标题和内容表格的起始绑定，同时让内容表格允许自动分页：

// 创建一个外层表格，用来承载标题和内容，确保标题与内容起始同页
Table outerContainer = new Table(1);
outerContainer.setWidth(UnitValue.createPercentValue(100));

// 1. 处理表格标题：设置keepWithNext，确保和下一个元素（内容表格）同页
Cell titleCell = new Cell().add(new Paragraph("你的表格标题"));
titleCell.setKeepWithNext(true); // 关键属性：强制标题和下一个元素同页
outerContainer.addCell(titleCell);

// 2. 处理内容表格：不设置全局keep together，允许内容分页
Table contentTable = new Table(1);
contentTable.setWidth(UnitValue.createPercentValue(100));

// 模拟大量内容（实际替换成你的业务内容）
for (int i = 1; i <= 60; i++) {
    contentTable.addCell(new Cell().add(new Paragraph("内容行 " + i)));
}

// 把内容表格加入外层容器，去掉不必要的边框
outerContainer.addCell(new Cell().add(contentTable).setBorder(Border.NO_BORDER));

// 将外层容器添加到文档中
document.add(outerContainer);

关键逻辑说明 #

• setKeepWithNext(true)：这个属性会告诉PDF渲染引擎，当前元素（标题单元格）必须和它后面的第一个元素（内容表格）出现在同一页。如果当前页剩下的空间放不下标题+内容表格的第一部分，标题会被自动推到下一页，内容跟着过去，彻底避免标题和内容分离的情况，也不会因为整个表格跳页产生大留白。
• 内容表格不设置keep together：这样当内容本身超过一页时，渲染引擎会自动拆分内容表格，在合适的位置分页，而标题始终和内容的开头牢牢绑在同一页。

额外小提示 #

如果你的标题不是放在Cell里，而是直接用Paragraph，也可以直接给Paragraph设置setKeepWithNext(true)，然后紧跟内容表格，效果是一样的：

Paragraph title = new Paragraph("你的表格标题");
title.setKeepWithNext(true);
document.add(title);
document.add(contentTable);

内容的提问来源于stack exchange，提问作者ashish pal