XSL-FO表格行分页需求：keep-together.within-page灵活配置问询

这个需求我之前做评分对比表格项目时也碰到过，核心就是要避开keep-together.within-page='always'的“一刀切”问题——既要让短行完整留在同一页，又要允许超长行在单页放不下时自动拆分。下面是几个经过实践验证的可行方案：

方案1：用标准属性page-break-inside: avoid实现“优先保持整行” #

这是最通用的XSL-FO解决方案，不需要依赖任何扩展：

• 先把table-row的keep-together.within-page恢复为默认的auto（可以直接省略这个属性）；
• 给table-row加上page-break-inside: avoid属性：

  <fo:table-row page-break-inside="avoid">
    <!-- 你的表格单元格内容 -->
  </fo:table-row>
  

这个属性的逻辑完全贴合你的需求：尽量避免在该行内部插入分页符，但如果该行内容高度确实超过了当前页面剩余空间（甚至超过单页总高度），FOP会自动放弃“不拆分”的尝试，将行拆分到多页显示。

如果单元格里有嵌套的复杂内容（比如多行文本块、小表格），可以给单元格内的顶级fo:block也加上page-break-inside: avoid，确保单元格内容优先保持完整，实在放不下再拆分。

方案2：Apache FOP扩展属性实现精准控制 #

如果你用的是Apache FOP，它提供了一个专门的扩展属性fox:keep-together.within-page，其中的auto值正好对应你想要的“always if possible”效果：

• 给table-row设置：

  <fo:table-row fox:keep-together.within-page="auto">
    <!-- 你的表格单元格内容 -->
  </fo:table-row>
  

这个扩展属性会智能判断：当整行能放进当前页面剩余空间时，保持整行不拆分；如果整行内容本身就超过单页高度，就允许拆分到多页。比标准属性更针对表格行场景，排版稳定性更好。

方案3：针对超长列单独处理 #

如果只有个别列的文本极长，可以单独给这些列的单元格设置宽松的保持规则，同时保留其他短列的整行完整性：

<fo:table-cell>
  <fo:block keep-together.within-page="auto">
    <!-- 超长文本内容 -->
  </fo:block>
</fo:table-cell>

这样短列的行依然会优先留在同一页，超长列的内容在需要时自动分页，兼顾两种场景的排版需求。

小提示 #

• 确保你的FOP版本在2.0以上，旧版本对page-break-inside和扩展属性的支持可能存在bug；
• 不要给整个表格设置keep-together.within-page="always"，否则会导致整个表格强制挤在一页，内容过长时直接溢出。

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