如何在 mPDF 中限制内容单页显示并自动截断溢出文本

本文介绍一种实用方法，通过预估行数控制 mpdf 输出内容高度，确保列表严格限制在单页内；当内容即将超出页面剩余空间时，自动截断并以“...”替代后续内容，避免分页。

处理过PDF报表生成的开发者，大多都遇到过这个头疼的问题：一个动态列表，比如订单明细或者日志条目，内容长度完全不可控。当它太长时，mPDF会很“自然”地将其分到下一页。这在大多数情况下没问题，但有些特殊场景可不行。

想想看，预览缩略页、票据打印，或者需要嵌入到其他文档中的报表，往往要求内容必须严格限制在一页之内。超出的部分，不能简单地分页，而是需要被优雅地截断，并给用户一个明确的提示——后面还有内容，但这里放不下了。

问题来了，mPDF本身并没有提供一个现成的指令，比如“禁止分页并自动截断”。所以，我们得自己动手，采用一种基于行高估算的主动截断策略。说白了，核心思路就是：在把数据扔给mPDF生成HTML之前，我们先模拟一下排版，动态统计已经“消耗”了多少行。一旦发现快要触达页面的行数上限，就立刻停止循环，并追加一个省略号标识。

✅ 实现步骤与关键要点

1. 确定单页可用行数（需实测校准）
   这里有个关键点：行数不等于简单的像素高度。它是由字体、字号、行高、页边距，甚至页眉页脚共同决定的。怎么确定呢？建议走一遍这个流程：

   • 创建一个最简化的测试模板（只包含基础CSS，比如 `body { font-family: sans-serif; font-size: 10pt; line-height: 1.4; }`）。
   • 用一个固定高度的容器（例如 `
     `）来模拟A4纸的实际可用区域。
   • 手动填充10行、20行、30行的纯文本，然后导出PDF，观察实际在哪里换页。
   • 根据测试结果，你会得到一个经验值。通常，在10pt字体、标准边距下，这个值大概在25到35行之间。

2. 按字符长度粗略估算行占用
   接下来，我们需要预估每条内容会占用几行。这取决于单行能容纳多少字符。公式很简单：单行容量 ≈ 可用宽度(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) . '
     ';
     }

3. 添加省略标识并闭合结构
   截断操作之后，千万别忘了给用户一个视觉提示，这是提升体验的关键一步：

   if ($lines_used >= $max_allowed_lines && count($data) > $n) {
       $html .= '
   ⋯
   '; // 也可以使用 HTML 实体 …
   }
   $html .= '