iTextPdf7 Java：固定单页A4 PDF页脚至页面底部的问题

你直接把页脚元素加到Document里的话，这些元素会跟着内容流走，当页面内容不多时就不会自动贴在底部。要实现固定在页面底部的页脚，最可靠的方式是利用iText7的PdfDocumentEvent（文档事件处理器），在页面渲染完成后，手动将页脚绘制在页面底部位置。

下面是完整的实现方案，包含你需要的分隔线和两行文本：

步骤1：自定义页脚事件处理器 #

创建一个继承自PdfDocumentEvent的类，在handleEvent方法中绘制页脚内容：

import com.itextpdf.kernel.colors.ColorConstants;
import com.itextpdf.kernel.geom.Rectangle;
import com.itextpdf.kernel.pdf.PdfDocument;
import com.itextpdf.kernel.pdf.PdfPage;
import com.itextpdf.kernel.pdf.PdfWriter;
import com.itextpdf.kernel.pdf.canvas.PdfCanvas;
import com.itextpdf.layout.Document;
import com.itextpdf.layout.element.Paragraph;
import com.itextpdf.layout.element.LineSeparator;
import com.itextpdf.layout.element.Div;
import com.itextpdf.layout.properties.HorizontalAlignment;
import com.itextpdf.layout.properties.UnitValue;
import com.itextpdf.layout.renderer.DrawContext;

public class FooterEventHandler extends com.itextpdf.kernel.pdf.PdfDocumentEvent {
    private final Document layoutDocument;

    public FooterEventHandler(Document layoutDocument) {
        this.layoutDocument = layoutDocument;
    }

    @Override
    public void handleEvent(com.itextpdf.kernel.pdf.PdfDocumentEvent event) {
        PdfDocument pdfDoc = event.getDocument();
        PdfPage page = event.getPage();
        Rectangle pageSize = page.getPageSize();
        
        // 定义页脚的位置：距离底部20pt，左右各留20pt边距
        float footerY = pageSize.getBottom() + 20;
        float footerWidth = pageSize.getWidth() - 40;

        // 1. 创建你需要的分隔线
        LineSeparator line = new LineSeparator(new com.itextpdf.kernel.pdf.canvas.draw.SolidLine(1f));
        line.setHorizontalAlignment(HorizontalAlignment.CENTER);
        line.setWidth(UnitValue.createPercentValue(70));
        
        // 2. 创建两行页脚文本
        Paragraph line1 = new Paragraph("第一行页脚文本").setFontSize(10).setHorizontalAlignment(HorizontalAlignment.CENTER);
        Paragraph line2 = new Paragraph("第二行页脚文本").setFontSize(10).setHorizontalAlignment(HorizontalAlignment.CENTER);
        
        // 3. 将元素放入Div统一管理
        Div footerDiv = new Div()
                .add(line)
                .add(line1)
                .add(line2)
                .setWidth(footerWidth)
                .setHorizontalAlignment(HorizontalAlignment.CENTER);
        
        // 4. 绝对定位到页面底部
        PdfCanvas canvas = new PdfCanvas(page.newContentStreamBefore(), page.getResources(), pdfDoc);
        DrawContext drawContext = new DrawContext(pdfDoc, canvas);
        footerDiv.setProperty(com.itextpdf.layout.properties.Property.POSITION, com.itextpdf.layout.properties.Position.ABSOLUTE);
        footerDiv.setX(pageSize.getLeft() + 20);
        footerDiv.setY(footerY);
        footerDiv.createRendererSubTree().setParent(layoutDocument.getRenderer()).draw(drawContext);
    }
}

步骤2：在PDF生成流程中绑定事件处理器 #

在初始化PdfDocument时，将自定义的页脚事件处理器绑定到END_PAGE事件（页面渲染结束时触发）：

public class PdfGenerator {
    public static void main(String[] args) throws IOException {
        String dest = "fixed_footer.pdf";
        PdfWriter writer = new PdfWriter(dest);
        PdfDocument pdfDoc = new PdfDocument(writer);
        Document layoutDocument = new Document(pdfDoc);

        // 绑定页脚事件处理器
        pdfDoc.addEventHandler(com.itextpdf.kernel.pdf.PdfDocumentEvent.END_PAGE, new FooterEventHandler(layoutDocument));

        // 添加你的页面主体内容
        layoutDocument.add(new Paragraph("这是页面主体内容").setFontSize(16));

        layoutDocument.close();
    }
}

关键说明 #

• 使用POSITION.ABSOLUTE绝对定位，确保页脚固定在页面底部的指定位置，完全不受主体内容长度影响。
• 通过END_PAGE事件，在每个页面渲染完成后绘制页脚，单页PDF也能完美适配。
• 你可以根据需求调整footerY（页脚距离底部的距离）、边距、字体大小、分隔线宽度等参数，适配你的设计要求。

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