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

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

在使用 mPDF 生成 PDF 报表时，常遇到动态列表（如订单明细、日志条目）因长度不可控而自然跨页的问题。但某些场景（如预览缩略页、票据打印、嵌入式报表）要求强制单页输出——超出部分不能分页，而应优雅截断并提示用户内容被省略。

mPDF 本身不提供“禁止分页 + 自动截断”的内置指令，因此需采用基于行高估算的主动截断策略。核心思路是：在生成 HTML 内容前，模拟排版逻辑，动态统计当前已占用行数，并在接近页面可用行数上限时提前终止循环，追加省略标识。

✅ 实现步骤与关键要点

1. 确定单页可用行数（需实测校准）
   行数 ≠ 像素高度，而是由字体、字号、行高、页边距、页眉页脚共同决定。建议：

   • 创建最小测试模板（仅含基础 CSS：body { font-family: sans-serif; font-size: 10pt; line-height: 1.4; }）
   • 用固定高度容器（如
     ）模拟 A4 可用区域
   • 手动填充 10/20/30 行纯文本，导出 PDF 观察实际换行位置
   • 推荐起始值：25–35 行（10pt 字体、标准边距下常见）

   • 按字符长度粗略估算行占用
     单行能容纳的字符数 ≈ 可用宽度(px) / 平均字符宽度(px)。若使用等宽字体可精确计算；否则按经验阈值近似：

     • 普通中文字体（如 dejavusans）下，10pt 时单行约容纳 80–120 字符

     • 超长行会自动折行，需额外计数：

       

       GitMind思乎

       GitMind思乎是一款AI思维导图工具，AI驱动的免费思维导图工具。

       下载

       $single_line_limit = 100; // 根据实测调整
       $lines_used = 0;
       
       foreach ($data as $line) {
           $lines_used++; // 默认占 1 行
       
           // 折行补偿：每超限 100 字符，+1 行（支持最多 3 行）
           $extra_lines = (int) floor(strlen($line) / $single_line_limit);
           $lines_used += min($extra_lines, 2); // 最多再加 2 行（即总占 3 行）
       
           if ($lines_used > $max_allowed_lines) {
               break;
           }
           $html .= '<div class="list-item">' . htmlspecialchars($line) . '</div>';
       }

   • 添加省略标识并闭合结构
     截断后务必追加视觉提示，增强用户体验：

       if ($lines_used >= $max_allowed_lines && count($data) > $n) {
           $html .= '<div class="ellipsis">⋯</div>'; // 或使用 …
       }
       $html .= '