MPDF分页控制完全指南：掌握页面分割与避免技巧

前言

在PDF文档生成过程中，合理的分页控制是保证文档专业性和可读性的关键。本文将全面介绍MPDF库中的分页控制功能，帮助开发者精确控制PDF文档的页面布局。

基础分页方法

1. 强制分页

MPDF提供了两种强制分页的方式：

PHP方式：

$mpdf->AddPage();

HTML方式：

<div style="page-break-before: always;"></div>

在强制分页时，可以同时定义新页面的属性：

• 页面方向（横向/纵向）
• 页边距设置
• 页码显示控制
• 页眉页脚配置

2. 目录分页

MPDF提供了特殊的目录分页标记，既能分页又能为目录生成标记位置：

$mpdf->TOCpagebreak();

或HTML方式：

<tocpagebreak />

高级分页控制

1. 避免分页的情况

MPDF提供了几种避免不理想分页的机制：

CSS控制：

div.no-break {
    page-break-inside: avoid;
}

标题与表格保持：

$mpdf->use_kwt = true; // 启用"保持标题与表格在一起"功能

此功能会自动为紧接在表格前的H1-H6标题设置page-break-inside: avoid，确保标题和表格不被分页分开。

2. 表格分页处理

当表格设置page-break-inside: avoid但无法完整放入当前页时，MPDF会尝试：

1. 自动缩放表格（默认最大缩放比例为1.4倍）
2. 如果缩放后仍无法放入，则整体移至下一页

控制缩放行为：

$mpdf->shrink_tables_to_fit = 1; // 禁用表格缩放

或在HTML中针对特定表格：

<table autosize="1">...</table>

分页类型详解

MPDF 6.0+引入了三种分页处理方式：

1. 切片式(slice)：在分页处不添加边框和内边距
2. 完全克隆(cloneall)：在每个页面片段上完整重现所有开放元素的边框和内边距
3. CSS克隆(clonebycss)：仅对设置了box-decoration-break: clone的元素进行克隆

示例配置：

div {
    box-decoration-break: clone; /* 或 slice */
}

分页行为对照表

分页触发方式	默认处理类型	可配置性
自动分页	slice	不可配置
目录分页()	cloneall	不可配置
表单分页()	slice	不可配置
多列布局分页	cloneall	不可配置
@page选择器变更分页	cloneall	不可配置
普通分页()	cloneall	可通过属性配置
CSS分页属性触发	cloneall	可通过变量配置

最佳实践建议

1. 表格处理：

   • 对于大型表格，考虑禁用自动缩放或设置合理的最大缩放比例
   • 重要表格建议使用page-break-inside: avoid

2. 标题处理：

   • 启用use_kwt功能保持标题与内容完整
   • 对于多级标题，合理使用box-decoration-break

3. 分页类型选择：

   • 常规文档使用默认的cloneall类型
   • 对样式复杂的文档考虑使用clonebycss进行精细控制

常见问题解答

Q：为什么我的表格在分页时样式不一致？ A：检查是否设置了合适的page-break-inside属性，并考虑调整shrink_tables_to_fit值。

Q：如何确保标题和后续内容不被分页分开？ A：启用$mpdf->use_kwt = true;或手动为标题添加page-break-after: avoid。

Q：分页处的边框显示不完整怎么办？ A：尝试更改分页类型为cloneall或为相关元素设置box-decoration-break: clone。

通过掌握这些分页控制技巧，您可以生成更加专业、易读的PDF文档，满足各种复杂的排版需求。