XSL-FO keep-with-previous 属性（手把手讲解）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

在文档排版领域，XSL-FO（XSL Formatting Objects）是一种强大的语言，用于定义文档的版面布局和样式。无论是生成 PDF 报表、书籍、技术文档，还是复杂的多栏布局，XSL-FO 都能提供精细的控制能力。然而，对于初学者和中级开发者来说，XSL-FO 中的一些高级属性可能显得晦涩难懂。其中，keep-with-previous 属性便是这类属性之一，它直接影响文档元素在页面上的排列逻辑，是解决分页、换行或断行问题的核心工具。

本文将通过循序渐进的方式，结合实际案例和代码示例，深入解析 keep-with-previous 属性的功能、用法及最佳实践，帮助读者掌握这一工具的精髓。

一、从排版需求出发：为什么需要 keep-with-previous？

在文档排版中，开发者常遇到以下场景：

1. 标题与内容分离：例如，章节标题出现在页面底部，而对应的正文内容被强制移到下一页。
2. 表格跨页断裂：表格的表头和表体被分隔到不同页面，导致读者需要来回翻页查看数据。
3. 列表项断行混乱：长列表项因换行而失去逻辑关联性。

为解决这些问题，XSL-FO 提供了 keep-with-previous 属性。其核心作用是：控制当前元素与前一个元素在页面上的保持关系，防止它们因分页或换行而被拆分。

二、属性基础：keep-with-previous 的语法与取值

1. 语法结构

keep-with-previous 是一个 XSL-FO 元素的属性，其语法如下：

<fo:block keep-with-previous="[值]">  
  内容  
</fo:block>  

2. 允许的取值

该属性的取值分为两类：预定义关键字和数值型权重：

（1）预定义关键字

• always：强制要求当前元素与前一个元素保持在同一页面或同一行。
• never：允许当前元素与前一个元素被拆分。
• auto（默认值）：由排版引擎根据页面空间自动判断是否保持。

（2）数值型权重

通过 n 或 n m 的形式定义权重，其中：

• n 表示“保持”的权重，取值范围为 0（最低）到 1003（最高）。
• m 表示“拆分”的权重（可选），若省略则默认为 0。

示例：

• keep-with-previous="500"：权重为 500，倾向于保持。
• keep-with-previous="500 200"：保持权重 500，拆分权重 200，最终净权重为 500 - 200 = 300。

3. 权重的逻辑规则

当多个元素同时设置 keep-with-previous 时，排版引擎会根据权重进行优先级排序：

• 权重越高，越倾向于保持相邻元素；
• 若总权重超过 1000，则强制保持（等同于 always）。

三、实战案例：如何使用 keep-with-previous？

案例 1：防止标题与正文分离

假设我们有一个章节标题和对应的正文内容，希望标题始终与正文的第一段保持在同一页面：

<fo:flow flow-name="xsl-region-body">  
  <fo:block font-weight="bold"  
            keep-with-previous="always">  
    3.1 系统架构设计  
  </fo:block>  
  <fo:block keep-with-previous="always">  
    本节将详细描述系统的模块划分与交互流程...  
  </fo:block>  
</fo:flow>  

解析：

• 标题块设置了 keep-with-previous="always"，但由于它是第一个元素，实际效果取决于其后元素的设置。
• 正文块通过 keep-with-previous="always"，强制要求自身与前一个元素（标题）保持在一起。

案例 2：处理表格跨页问题

表格的表头和表体常因页面空间不足而分离，此时可为表格行设置权重：

<fo:table>  
  <fo:table-body>  
    <fo:table-row keep-with-previous="500">  
      <fo:table-cell>表头内容</fo:table-cell>  
    </fo:table-row>  
    <!-- 后续表格行 -->  
  </fo:table-body>  
</fo:table>  

解析：

• 通过为表头行设置 keep-with-previous="500"，增强其与前一行（可能是其他表头或内容）的关联性。

案例 3：列表项的连贯性

对于长列表项，可结合 keep-with-previous 和 keep-together 属性：

<fo:list-block provisional-distance-between-starts="24pt">  
  <fo:list-item keep-with-previous="auto">  
    <fo:list-item-label>  
      <fo:block>(1)</fo:block>  
    </fo:list-item-label>  
    <fo:list-item-body>  
      <fo:block>  
        这是一个需要保持与前一项关联的长描述文本...  
      </fo:block>  
    </fo:list-item-body>  
  </fo:list-item>  
</fo:list-block>  

解析：

• 使用 keep-with-previous="auto" 允许引擎根据空间自动调整，避免因强行保持导致页面过度拥挤。

四、进阶技巧：属性的局限性与优化策略

1. 属性的继承与作用范围

• 继承规则：keep-with-previous 不会自动继承父元素的设置，需显式声明。
• 作用范围：仅对当前元素与直接前驱元素生效，无法跨多级元素保持。

2. 处理复杂场景的策略

（1）多级保持：链式设置

当需要保持多个元素的连续性时，需为每个元素设置 keep-with-previous：

<fo:block>标题</fo:block>  
<fo:block keep-with-previous="always">内容1</fo:block>  
<fo:block keep-with-previous="always">内容2</fo:block>  

（2）结合 keep-together 属性

对于需要整体保持的块级元素（如表格或列表），可同时使用 keep-together：

<fo:table keep-together.within-page="always"  
          keep-with-previous="500">  
  <!-- 表格内容 -->  
</fo:table>  

（3）动态调整权重

在空间不足时，可尝试降低权重或使用 auto：

<fo:block keep-with-previous="300">  
  <!-- 内容 -->  
</fo:block>  

3. 性能与可维护性建议

• 避免过度使用 always：强制保持可能导致页面留白过多，影响排版美观。
• 模块化代码：通过 XSL 变量或模板复用常用属性组合，例如：

  <xsl:variable name="default-keep" select="'300'"/>  
  <fo:block keep-with-previous="{$default-keep}">...</fo:block>  
  

五、常见问题与解决方案

问题 1：设置 always 后元素仍被拆分

原因：页面空间不足，且其他元素的权重更高。
解决方案：

• 减少页面内容，或调整其他元素的 keep 属性权重。
• 使用 force-page-count 强制增加页面数量。

问题 2：多个元素的 keep 权重冲突

原因：不同元素的权重设置相互抵消或竞争资源。
解决方案：

• 通过数值型权重明确优先级，例如 keep-with-previous="1000 0"。
• 分析排版引擎的日志，定位冲突点。

问题 3：如何调试 keep 属性效果？

方法：

• 使用 FOP（Formatting Objects Processor）的调试模式，输出排版日志。
• 在开发环境中逐步注释代码，观察元素位置变化。

六、总结与展望

keep-with-previous 是 XSL-FO 中不可或缺的工具，它通过灵活的权重机制和关键字控制，帮助开发者实现文档的逻辑连贯性。无论是防止标题与正文分离，还是确保表格的完整性，这一属性都能显著提升排版质量。

然而，掌握 keep-with-previous 仅是排版优化的起点。开发者还需结合其他属性（如 keep-with-next、keep-together）和排版引擎特性，构建更复杂的布局策略。随着文档需求的多样化，XSL-FO 的 keep 机制将持续为开发者提供精准的控制能力，确保输出文档既美观又实用。

希望本文能成为您探索 XSL-FO 排版世界的指南，助您在实际项目中游刃有余地应对各类挑战。