为何设置block-progression-dimension.maximum=25pvh后XSLFO表格单元格高度未生效？

我尝试通过设置<fo:table-cell block-progression-dimension.maximum="25pvh"/>，将表格单元格及其中的高图片限制为页面高度的25%，但包含单个单元格的表格仍占满了可用内容高度，代码如下：

<fo:table table-layout="auto" border-collapse="collapse" keep-together.within-page="always">
  <fo:table-body>
    <fo:table-row>
      <fo:table-cell block-progression-dimension.maximum="25pvh">
        <fo:block>
          <fo:external-graphic 
scaling="uniform" 
src="images/tall.png" 
content-height="scale-down-to-fit" 
inline-progression-dimension.maximum="auto" 
inline-progression-dimension.optimum="auto" 
inline-progression-dimension.minimum="auto" 
block-progression-dimension.minimum="auto" 
block-progression-dimension.optimum="auto" 
block-progression-dimension.maximum="100%" />
        </fo:block>
      </fo:table-cell>
    </fo:table-row>
  </fo:table-body>
</fo:table>

实际效果为图片及表格占满页面可用高度，未被限制在预期的25%比例。

问题原因 #

• 表格布局模式优先级冲突：使用table-layout="auto"时，表格会优先根据内容自动计算尺寸，单元格的block-progression-dimension.maximum限制会被内容的原始尺寸覆盖，导致表格被图片撑开。
• 缺少表格容器的高度约束：仅设置单元格的高度上限，但表格本身没有高度限制，会自适应单元格内容的实际高度，完全忽略单元格的max限制。
• 图片缩放的前置条件未满足：content-height="scale-down-to-fit"需要父容器有明确的高度上限才能触发缩放，否则图片会保持原始尺寸，进一步撑开单元格和表格。

解决方案 #

调整代码时需要从外层容器到内层内容逐层约束尺寸逻辑，修改后的代码如下：

<fo:table table-layout="fixed" 
          border-collapse="collapse" 
          keep-together.within-page="always"
          block-progression-dimension.maximum="25pvh"> <!-- 限制表格最大高度为页面25% -->
  <fo:table-body>
    <fo:table-row block-progression-dimension.maximum="100%"> <!-- 行继承表格高度限制 -->
      <fo:table-cell block-progression-dimension.maximum="100%"> <!-- 单元格继承行的高度限制 -->
        <fo:block height="100%" overflow="hidden"> <!-- 为图片提供明确高度容器，溢出隐藏 -->
          <fo:external-graphic 
            scaling="uniform" 
            src="images/tall.png" 
            content-height="scale-down-to-fit"
            content-width="scale-down-to-fit"
            block-progression-dimension.maximum="100%"
            inline-progression-dimension.maximum="100%" />
        </fo:block>
      </fo:table-cell>
    </fo:table-row>
  </fo:table-body>
</fo:table>

关键调整说明 #

• 给表格设置最大高度：在<fo:table>上添加block-progression-dimension.maximum="25pvh"，从最外层容器锁定高度上限。
• 切换为固定表格布局：table-layout="fixed"让表格优先遵循设置的尺寸规则，不再自适应内容原始尺寸。
• 逐层继承高度限制：将表格行和单元格的最大高度设为100%，确保它们继承表格的25pvh高度约束。
• 添加块容器的明确高度：<fo:block height="100%" overflow="hidden">为图片提供明确的高度参考，同时防止内容溢出容器。
• 简化图片属性：保留必要的缩放规则和尺寸限制，确保图片在容器内按比例缩放到合适大小。

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