iText无法识别AEM模板地址字段上移逻辑，如何实现下方字段自动上移？

方案1：保留XFA表单结构，依赖阅读器执行原有脚本 #

AEM Designer生成的模板属于XFA表单，你原本的JavaScript是XFA的动态布局脚本。iText默认处理AcroForm时会忽略XFA逻辑，但可以通过iText的XFA模块直接操作XFA数据集，保留原始脚本逻辑，让PDF阅读器打开时自动执行字段隐藏和上移。

代码示例（iText 7 + itext7-xfa模块） #

// 加载XFA模板（支持AEM Designer导出的XDP或生成的PDF）
PdfDocument pdfDoc = new PdfDocument(new PdfReader("address-template.pdf"), new PdfWriter("output.pdf"));
XfaForm xfa = pdfDoc.getCatalog().getXfaForm();

// 填充地址数据到XFA数据集
String addrLine2 = data.getCustomer().getAddrLine2();
xfa.getDatasetsNode().findNode("ADDLINE2").setValue(addrLine2 != null ? addrLine2 : "");
xfa.getDatasetsNode().findNode("ADDLINE1").setValue(data.getCustomer().getAddrLine1());
xfa.getDatasetsNode().findNode("CITY").setValue(data.getCustomer().getCity());
xfa.getDatasetsNode().findNode("STATE").setValue(data.getCustomer().getState());
xfa.getDatasetsNode().findNode("ZIP").setValue(data.getCustomer().getZip());

pdfDoc.close();

生成的PDF会保留XFA结构，用户用Adobe Reader等支持XFA的阅读器打开时，原有JavaScript会自动触发：当ADDLINE2为空时隐藏该字段，并将下方的City、State、Zip自动上移。

方案2：手动调整AcroForm字段位置（兼容非XFA阅读器） #

如果必须生成纯AcroForm（不依赖XFA），需要在隐藏ADDLINE2后，手动修改City、State、Zip字段的坐标，实现上移效果。核心是获取字段的原始位置，根据ADDLINE2的高度调整下方字段的Y坐标。

代码示例（iText 7） #

PdfDocument pdfDoc = new PdfDocument(new PdfReader("template.pdf"), new PdfWriter("output.pdf"));
PdfAcroForm form = PdfAcroForm.getAcroForm(pdfDoc, true);

String addLine2FieldName = "Correspondence[0].Page1[0].FooterContent[0].TemplateContent1[0].AddressBox[0].ADDLINE2[0]";
PdfFormField addLine2 = form.getField(addLine2FieldName);
boolean isAddLine2Empty = data.getCustomer().getAddrLine2() == null || data.getCustomer().getAddrLine2().isEmpty();

// 隐藏或显示ADDLINE2
addLine2.setVisibility(isAddLine2Empty ? PdfFormField.HIDDEN : PdfFormField.VISIBLE);
addLine2.setValue(data.getCustomer().getAddrLine2() != null ? data.getCustomer().getAddrLine2() : "");

if (isAddLine2Empty) {
    // 获取ADDLINE2的高度（从字段Widget的Rectangle中获取）
    Rectangle addLine2Rect = addLine2.getWidgets().get(0).getRectangle();
    float fieldHeight = addLine2Rect.getHeight();
    
    // 调整各字段位置
    adjustFieldPosition(form, "Correspondence[0].Page1[0].FooterContent[0].TemplateContent1[0].AddressBox[0].CITY[0]", fieldHeight);
    adjustFieldPosition(form, "Correspondence[0].Page1[0].FooterContent[0].TemplateContent1[0].AddressBox[0].STATE[0]", fieldHeight);
    adjustFieldPosition(form, "Correspondence[0].Page1[0].FooterContent[0].TemplateContent1[0].AddressBox[0].ZIP[0]", fieldHeight);
}

pdfDoc.close();

// 封装字段位置调整方法
private static void adjustFieldPosition(PdfAcroForm form, String fieldName, float offset) {
    PdfFormField field = form.getField(fieldName);
    if (field == null) return;
    
    Rectangle originalRect = field.getWidgets().get(0).getRectangle();
    // PDF坐标系以左下角为原点，top值越大越靠上，向上偏移需增加top值
    Rectangle newRect = new Rectangle(
        originalRect.getLeft(),
        originalRect.getTop() + offset,
        originalRect.getWidth(),
        originalRect.getHeight()
    );
    field.getWidgets().get(0).setRectangle(newRect);
}

注意事项 #

• 需提前确认每个地址字段的原始高度和垂直间距，确保偏移量准确；
• 若模板中字段位置修改，代码中的偏移量或字段路径需同步更新；
• 该方案生成纯AcroForm，几乎所有PDF阅读器都能正常显示。

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