iText7中当前页空间不足时如何将页脚表格移至下一页

你遇到重叠问题的核心原因是用IEventHandler实现可变高度页脚的思路本身就有问题：IEventHandler挂载的页脚绘制逻辑是在页面内容已经全部排版完成后才触发的，这个阶段页面上的表格、文字已经固定了位置，后续绘制的页脚不会触发内容重排，自然会和已经落位的主体内容重叠。不管你在事件里怎么计算剩余高度，都没法让已经排好的表格自动上移或者跳到新页。
另外可变高度页眉如果只做绘制不动态调整页面边距，也会出现页眉压内容的问题。

页眉可以继续通过IEventHandler实现，页脚必须放弃事件挂载的方式，改用「预排版算高+判断追加」的逻辑实现，具体步骤如下：

• 每一页触发渲染时，先绘制可变高度页眉，实时计算页眉的实际占用高度，动态调整当前页的上边距，保证主体内容永远不会进入页眉区域
• 主体可变高度表格正常添加到文档，利用iText7原生的表格自动跨页拆分能力完成分页
• 所有主体内容排版完成后，先计算待添加的可变页脚的实际高度，再对比最后一页的剩余可用空间
• 剩余空间足够放下页脚就直接在当前页追加页脚，空间不足就先插入分页符，把页脚放到新的空白页
• 因为页眉事件是绑定到页面启动阶段的，哪怕新增了放页脚的空白页，也会自动渲染对应页眉，不需要额外处理

可变页眉事件处理器 #

public class VariableHeaderEventHandler : IEventHandler
{
    public void HandleEvent(Event currentEvent)
    {
        PdfDocumentEvent docEvent = (PdfDocumentEvent)currentEvent;
        PdfPage page = docEvent.GetPage();
        PdfCanvas pdfCanvas = new PdfCanvas(page.NewContentStreamBefore(), page.GetResources(), docEvent.GetDocument());
        Canvas headerCanvas = new Canvas(pdfCanvas, page.GetPageSize());

        // 替换为你自己的可变页眉构建逻辑，支持任意高度的文本、表格、图片
        Table dynamicHeader = BuildCustomHeader();
        headerCanvas.Add(dynamicHeader);

        // 动态获取页眉实际高度，调整页面上边距，预留10px作为内容和页眉的缓冲间距
        float actualHeaderHeight = dynamicHeader.GetRenderer().GetOccupiedArea().GetBBox().GetHeight();
        page.SetMarginTop(actualHeaderHeight + 10);

        headerCanvas.Close();
    }

    // 自定义页眉构建方法，按你的业务需求实现
    private Table BuildCustomHeader()
    {
        // 业务逻辑省略
        return new Table(1).UseAllAvailableWidth().AddCell("动态页眉");
    }
}

文档生成与页脚处理逻辑 #

// 初始化PDF文档
PdfDocument pdfDoc = new PdfDocument(new PdfWriter("output.pdf"));
Document doc = new Document(pdfDoc);

// 注册页眉事件，所有页面（包括后续新增的页脚页）都会自动渲染页眉
pdfDoc.AddEventHandler(PdfDocumentEvent.START_PAGE, new VariableHeaderEventHandler());

// 添加主体可变高度表格，iText会自动处理跨页拆分
Table mainContentTable = BuildMainTable();
doc.Add(mainContentTable);

// 预计算可变页脚的实际高度
Table dynamicFooter = BuildCustomFooter();
IRenderer footerRenderer = dynamicFooter.CreateRendererSubTree();
LayoutResult footerLayoutResult = footerRenderer.Layout(new LayoutContext(new LayoutArea(1, pdfDoc.GetDefaultPageSize())));
float footerActualHeight = footerLayoutResult.GetOccupiedArea().GetBBox().GetHeight();

// 获取最后一页的剩余可用高度
PdfPage lastPage = pdfDoc.GetLastPage();
float pageBottomLimit = lastPage.GetCropBox().GetBottom() + lastPage.GetMarginBottom();
float currentContentBottomPos = doc.GetRenderer().GetCurrentArea().GetBBox().GetBottom();
float remainingSpace = currentContentBottomPos - pageBottomLimit;

// 剩余空间不足时插入分页符，预留10px作为缓冲间距
if (remainingSpace < footerActualHeight + 10)
{
    doc.Add(new AreaBreak(AreaBreakType.NEXT_PAGE));
    // 分页后重置页脚的上边距为0
    dynamicFooter.SetMarginTop(0);
}
else
{
    // 空间足够时设置上边距，把页脚顶到页面底部位置
    dynamicFooter.SetMarginTop(remainingSpace - footerActualHeight);
}

// 追加页脚到文档
doc.Add(dynamicFooter);

doc.Close();

• 不要给文档设置固定的上下边距，可变页眉/页脚的边距必须在渲染时动态计算调整，固定值必然会出现内容重叠或者留白异常
• 不要尝试在END_PAGE事件里处理页脚的分页逻辑，该阶段页面内容流已经写入完成，无法触发重排
• 如果页眉内容高度差异极大（比如部分页面页眉带多行说明、表格，部分页面只有单行标题），必须每次渲染页眉时重新计算高度更新边距，不能复用之前页面的边距值

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