如何在 mPDF 中限制内容单页显示并自动截断溢出文本
本文介绍一种实用方法，通过预估行数控制 mpdf 输出内容高度，确保列表严格限制在单页内；当内容即将超出页面剩余空间时，自动截断并以“...”替代后续内容，避免分页。 处理过PDF报表生成的开发者，大多都遇到过这个头疼的问题：一个动态列表，比如订单明细或者日志条目，内容长度完全不可控。当它太长时，m
本文介绍一种实用方法，通过预估行数控制 mpdf 输出内容高度，确保列表严格限制在单页内；当内容即将超出页面剩余空间时，自动截断并以“...”替代后续内容，避免分页。
处理过PDF报表生成的开发者，大多都遇到过这个头疼的问题：一个动态列表，比如订单明细或者日志条目，内容长度完全不可控。当它太长时，mPDF会很“自然”地将其分到下一页。这在大多数情况下没问题，但有些特殊场景可不行。
想想看，预览缩略页、票据打印，或者需要嵌入到其他文档中的报表，往往要求内容必须严格限制在一页之内。超出的部分，不能简单地分页，而是需要被优雅地截断，并给用户一个明确的提示——后面还有内容，但这里放不下了。
问题来了，mPDF本身并没有提供一个现成的指令，比如“禁止分页并自动截断”。所以，我们得自己动手，采用一种基于行高估算的主动截断策略。说白了，核心思路就是：在把数据扔给mPDF生成HTML之前，我们先模拟一下排版，动态统计已经“消耗”了多少行。一旦发现快要触达页面的行数上限，就立刻停止循环，并追加一个省略号标识。
✅ 实现步骤与关键要点
-
确定单页可用行数（需实测校准）
这里有个关键点：行数不等于简单的像素高度。它是由字体、字号、行高、页边距，甚至页眉页脚共同决定的。怎么确定呢？建议走一遍这个流程：- 创建一个最简化的测试模板（只包含基础CSS，比如 `body { font-family: sans-serif; font-size: 10pt; line-height: 1.4; }`）。
- 用一个固定高度的容器（例如 ``）来模拟A4纸的实际可用区域。'; // 记得关闭外层容器
- 手动填充10行、20行、30行的纯文本，然后导出PDF，观察实际在哪里换页。
- 根据测试结果，你会得到一个经验值。通常，在10pt字体、标准边距下，这个值大概在25到35行之间。
按字符长度粗略估算行占用
接下来，我们需要预估每条内容会占用几行。这取决于单行能容纳多少字符。公式很简单：单行容量 ≈ 可用宽度(px) / 平均字符宽度(px)。如果用的是等宽字体，可以精确计算；否则，就需要一个经验阈值来近似估算。以常用的中文字体（比如deja vusans）为例，在10pt字号下，单行大约能容纳80到120个字符。
对于那些超长的行，mPDF会自动折行，我们需要在计数时把这部分“额外行数”补偿进去。看看下面这段代码的逻辑：
$single_line_limit = 100; // 这个阈值需要根据你的实测结果调整 $lines_used = 0; foreach ($data as $line) { $lines_used++; // 默认先计为1行 // 折行补偿：每超过100个字符，就多计1行（这里限制最多额外补偿2行，即一条内容最多占3行） $extra_lines = (int) floor(strlen($line) / $single_line_limit); $lines_used += min($extra_lines, 2); if ($lines_used > $max_allowed_lines) { break; // 触及上限，立刻跳出循环 } $html .= '' . htmlspecialchars($line) . ''; }
添加省略标识并闭合结构
截断操作之后，千万别忘了给用户一个视觉提示，这是提升体验的关键一步：if ($lines_used >= $max_allowed_lines && count($data) > $n) { $html .= '⋯'; // 也可以使用 HTML 实体 … } $html .= ' -
完整示例（含 CSS 优化）
把上面的思路整合起来，就是一个可以直接使用的完整代码片段了：$mpdf = new \Mpdf\Mpdf([ 'mode' => 'utf-8', 'format' => 'A4', 'margin_top' => 20, 'margin_bottom' => 15, 'margin_left' => 15, 'margin_right' => 15, ]); $max_allowed_lines = 28; // 这是经过实测确认的阈值 $single_line_limit = 95; $html = ''; $lines_used = 0; $n = 0; foreach ($data as $line) { $n++; $lines_used++; $len = mb_strlen($line, 'UTF-8'); // 对中文按字数估算会更准确，英文则按字符数 $est_lines = (int) ceil($len / $single_line_limit); $lines_used += max(0, $est_lines - 1); if ($lines_used > $max_allowed_lines) { break; } $html .= ''; $mpdf->WriteHTML($html); $mpdf->Output();' . htmlspecialchars($line, ENT_QUOTES, 'UTF-8') . ''; } if ($n < count($data)) { $html .= '⋯ ' . (count($data) - $n) . ' more items'; } $html .= '
⚠️ 注意事项
- 避免依赖 `page-break-inside: a void`：这个CSS属性在mPDF中的支持度有限，它并不能阻止内容溢出到新页面，通常只影响块级元素内部的断行行为。
- 慎用 `overflow: hidden`：在PDF渲染引擎里，这种像素级的裁剪样式通常是无效的，别指望它能帮你隐藏超出的内容。
- 动态内容需重测阈值：一旦你更换了字体、增大了字号，或者在列表项前加了图标，都必须重新校准 `$max_allowed_lines` 和 `$single_line_limit` 这两个关键参数。
- 进阶方案（可选）：如果项目对精度要求极高，可以探索结合 `mPDF::getPageSize()` 获取页面可用高度（单位毫米），再用 `mPDF::GetStringHeight()` 计算单行像素高度，从而实现像素级的精确截断。不过，这套方案的开发成本会显著上升。对于绝大多数业务场景来说，上面介绍的行数估算方法已经足够可靠和实用了。
通过以上这套方法，你无需深入修改mPDF的底层逻辑，就能稳定地实现单页强制截断的效果，在开发效率和输出可靠性之间找到一个不错的平衡点。
IntelliJ IDEA 是 JetBrains 推出的专业集成开发环境，重点服务于 Java、Kotlin 与 JVM 项目开发。软件集成代码补全、静态检查、重构、调试、测试、版本控制及构建工具，并可借助插件扩展语言和框架支持。
JetBrains PyCharm 是面向 Python 开发者的集成开发环境，提供智能补全、代码检查、重构、调试、测试、版本控制及虚拟环境管理功能。Mac 版兼容 Intel 与 Apple 芯片，核心功能可免费使用。
JetBrains WebStorm 是面向 JavaScript、TypeScript 和现代 Web 技术的专业集成开发环境，可智能理解项目结构，提供代码补全、重构、错误检查、运行调试、测试及 Git 工具。
Adobe After Effects 是面向动态图形、影视特效与视频合成的专业创作软件。它提供关键帧动画、遮罩抠像、运动跟踪、三维空间、文字动画和表达式等工具，并可与 Premiere Pro、Photoshop、Illustrator
Adobe Audition 是面向播客、影视后期、音乐制作及内容创作者的专业音频工作站，提供波形精修、多轨录制与混音、频谱编辑、降噪修复、响度匹配和效果处理工具，并可与 Adobe Premiere 协同完成视频声音制作。
Adobe Bridge 是面向摄影师、设计师及内容团队的免费数字资产管理工具，可集中预览照片、视频和 Adobe 项目文件，并利用评级、标签、关键词、元数据、筛选与收藏集完成分类检索。它还支持批量重命名、格式导出、相机导入及 Camera
Adobe Illustrator 是 Adobe 推出的专业矢量图形设计软件，适合在 Mac 上制作标志、图标、插画、包装、信息图及印刷版面。它以路径和锚点构建可无损缩放的图形，并提供钢笔、形状、文字、图像描摹、渐变、画板及生成式功能。
Adobe InDesign 是面向印刷品与数字出版物的专业版面设计软件，可在 Mac 上制作书籍、杂志、宣传册、海报、报告及交互式文档。它提供精细的文字样式、网格、母版、长文档管理和印前输出能力。
Adobe Lightroom Classic 是面向桌面摄影工作流的照片管理与后期处理软件，可将原始照片保存在本地硬盘，通过目录、关键词、评分和收藏夹高效整理图库，并提供 RAW 冲印、蒙版、镜头校正、批量同步及多格式导出等功能。
Adobe Media Encoder 是 Adobe 推出的专业音视频编码与转码工具，可通过队列、预设和监视文件夹批量完成格式转换、代理文件创建及多平台成片输出，并与 Premiere Pro、After Effects 等软件紧密协作。
Adobe Photoshop 是面向摄影师、设计师和内容创作者的专业图像处理软件，提供图层、蒙版、选区、修复、调色、文字排版、智能对象及生成式编辑等能力。Mac 版支持 Intel 与 Apple Silicon 处理器。
Adobe Premiere Pro 是面向专业视频制作的非线性剪辑软件，提供多轨时间线、调色、音频处理、字幕、代理工作流和多格式输出能力，并可与 After Effects、Audition、Photoshop 及 Frame.io 协同
JetBrains IntelliJ IDEA 是以 Java、Kotlin 和 JVM 项目为核心的专业集成开发环境，提供智能补全、代码检查、安全重构、调试、测试、版本控制及构建工具集成。统一发行版的核心功能可免费用于商业和非商业项目，
PhpStorm 是 JetBrains 面向 PHP 与现代 Web 开发打造的专业集成开发环境，提供代码补全、静态检查、重构、调试、测试、数据库、版本控制及前端语言支持。Windows 用户可直接下载安装程序，
PyCharm 是 JetBrains 推出的 Python 集成开发环境，提供智能代码补全、错误检查、重构、调试、测试、Git、终端及 Jupyter Notebook 支持。统一版安装后可体验 30 天 Pro 功能，
WebStorm 是 JetBrains 面向 JavaScript、TypeScript 和现代 Web 技术打造的集成开发环境。它提供项目级代码分析、智能补全、安全重构、导航搜索，并集成调试、测试、终端、Git 与常用前端工具，
Adobe Photoshop 是面向摄影师、设计师和内容创作者的专业图像处理工具，可在 Windows 上完成照片修饰、选区抠图、图层合成、文字排版、绘画及生成式编辑。软件采用订阅授权，由 Creative Cloud 管理安装、更新与许
Adobe InDesign 是面向印刷与数字出版的专业页面排版工具，可制作书籍、杂志、宣传册、海报、交互式 PDF 和电子书。它提供精细的文字样式、多页面管理、印前检查及多格式输出能力，并能与 Photoshop、Illustrator
Adobe Illustrator 是用于绘制矢量图形、插画、图标、徽标和版式的专业设计工具。它以路径和锚点为核心，作品放大后仍能保持清晰，并提供画板、文字、渐变、图像描摹及精确变换等功能，适合品牌视觉、印刷物料、数字界面和商业插画创作。
Adobe Bridge 是 Adobe 推出的创意资产管理工具，可集中预览、分类和查找照片、视频、PDF及多种设计文件，并支持元数据、关键词、评级、批量重命名和格式导出。它可与 Photoshop、Illustrator 等应用衔接，
Adobe Lightroom Classic 是面向 Windows 桌面摄影工作流的照片管理与无损编辑工具，可通过目录集中整理大型图库，并完成 RAW 显影、局部蒙版、批量调整、打印和多格式导出。它强调本地文件管理与精细控制，
Adobe Acrobat Pro 是面向专业 PDF 工作的综合解决方案，可在 Windows 中创建、编辑、转换、比较、整理和保护文档，并支持表单、电子签名、扫描件文字识别及敏感信息永久遮盖。订阅还包含网页、移动服务和云端协作能力，
Adobe After Effects 是面向动态图形、动画与影视视觉特效制作的专业工具，可完成关键帧动画、图层合成、遮罩跟踪、抠像、文字动画和二维三维元素整合。Windows 版通过 Adobe Creative Cloud 安装及更新，
Adobe Media Encoder 是 Adobe 面向视频与音频制作流程提供的专业编码和转码工具，可批量处理媒体文件、创建代理、套用输出预设并监控文件夹自动执行任务。它与 Premiere、After Effects、Audition