TCPDF如何实现商品与SKU区块同页显示？避免跨页拆分

方案一：使用CSS分页属性（推荐） #

TCPDF支持标准CSS分页规则，通过page-break-inside: avoid可以强制商品名称（P1）与对应SKU（P2）组成的区块不被拆分到两个页面。如果当前页面剩余空间不足以容纳整个区块，TCPDF会自动将整个区块移至下一页渲染。

由于你使用的是表格结构，推荐用<tbody>标签包裹单个商品的所有行（P1 + 所有P2），并为其添加CSS样式：

<tbody style="page-break-inside: avoid;">
    <tr nobr="true">
        <td>{{ $product->name }}</td>
        <td>{{ $otherInfo }}</td>
    </tr>

    @foreach ($product->skus as $sku)
        <tr nobr="true">
            <td>{{ $sku->number }}</td>
            <td>{{ $sku->quantity }}</td>
        </tr>
    @endforeach
</tbody>

注意：确保你的TCPDF版本支持CSS分页属性（多数新版本都支持），如果<tbody>不生效，也可以尝试用<div style="page-break-inside: avoid;">包裹整个商品的表格行，但表格结构下<tbody>的兼容性更好。

方案二：手动计算高度并插入分页符 #

如果CSS方法不符合需求，可以在PHP层面手动计算区块高度，与当前页面剩余空间比较，不足时主动触发分页：

@php
    // 自定义每行高度（根据你的PDF字号、行间距调整，单位mm）
    $singleRowHeight = 8;
    // 计算当前商品区块总高度：1行商品名 + N行SKU
    $totalBlockHeight = $singleRowHeight * (1 + count($product->skus));
    
    // 获取TCPDF当前页面剩余可用高度
    $currentY = $pdf->GetY();
    $pageTotalHeight = $pdf->getPageHeight() - $pdf->getTopMargin() - $pdf->getFooterMargin();
    $remainingHeight = $pageTotalHeight - $currentY;

    // 剩余高度不足时，新增一页
    if ($remainingHeight < $totalBlockHeight) {
        $pdf->AddPage();
    }
@endphp

<!-- 渲染商品与SKU行 -->
<tr nobr="true">
    <td>{{ $product->name }}</td>
    <td>{{ $otherInfo }}</td>
</tr>

@foreach ($product->skus as $sku)
    <tr nobr="true">
        <td>{{ $sku->number }}</td>
        <td>{{ $sku->quantity }}</td>
    </tr>
@endforeach

关键技术关键词 #

• TCPDF CSS分页：page-break-inside: avoid
• TCPDF 分页API：AddPage()、GetY()、getPageHeight()
• HTML表格区块化：<tbody>分组

内容的提问来源于stack exchange，提问作者Thanh Dao