TCPDF中单元格内容超出页面剩余空间时自动跳转新页的实现方法

架构老林

2026-8-16

TCPDF单元格内容超出时自动分页的实现方法

方法一：使用`MultiCell`自动处理分页

TCPDF的MultiCell方法专为多行文本输出设计，默认会自动检测当前页面剩余空间，当内容超出时自动跳转到新页面继续输出，是最省心的解决方案。示例代码：

// 设置字体
$pdf->SetFont('helvetica', '', 12);
// 准备超长内容
$longContent = "这里是需要输出的超长文本内容，当内容长度超过当前页面剩余可显示空间时，MultiCell会自动触发分页，将剩余内容输出到新页面中...";
// 输出内容，自动处理分页
$pdf->MultiCell(0, 10, $longContent, 0, 'L', false, 1, '', '', true, 0, false, true, 10, 'M');

参数说明：0表示单元格宽度自适应页面，10为行高，0代表无边框，'L'设置文本左对齐，其余参数控制换行、对齐细节及分页逻辑。

方法二：手动检查并触发分页（自定义场景）

如果需要在输出前做额外逻辑判断，可以用CheckPageBreak方法提前检测剩余空间，手动触发分页：

$cellHeight = 10;
// 检查当前单元格高度是否超出页面剩余空间
if (!$pdf->CheckPageBreak($cellHeight)) {
    // 空间足够，直接输出内容
    $pdf->Cell(0, $cellHeight, "需要输出的内容片段", 0, 1, 'L');
} else {
    // 空间不足，先新增页面再输出
    $pdf->AddPage();
    $pdf->Cell(0, $cellHeight, "需要输出的内容片段", 0, 1, 'L');
}

方法三：HTML表格自动分页

如果输出的是表格内容，推荐使用writeHTML方法输出HTML格式的表格，它会自动处理跨页的表格内容：

$htmlTable = '<table border="1">
    <tr>
        <td>这里是表格中的超长内容，当表格行超出当前页面时，会自动延续到下一页显示...</td>
    </tr>
</table>';
$pdf->writeHTML($htmlTable, true, false, true, false, '');