iTextPDF v9.2生成PDF：输入元素标签未显示值的解决方法咨询

当用iTextPDF v9.2把包含如下复选框的HTML转成PDF时：

<input type="checkbox" id="$elementId" name="cbk" value="Yes" checked/>

PDF表单里只会显示“Path”，复选框的value值“Yes”没出现在标签里，这里提供几种可行的解决方式：

方式一：手动设置表单字段的导出值 #

完成HTML到PDF的基础转换后，获取PdfDocument实例，找到对应表单字段，手动设置其导出值：

// 假设已获取到转换后的PdfDocument对象
PdfAcroForm form = PdfAcroForm.getAcroForm(pdfDocument, true);
PdfFormField checkBoxField = form.getField("cbk");
if (checkBoxField != null) {
    // 将导出值设为"Yes"
    checkBoxField.setExportValue("Yes");
    // 启用外观更新，确保显示生效
    checkBoxField.setNeedAppearances(true);
}

方式二：通过关联隐藏Label+配置ConverterProperties #

修改HTML结构，给复选框加个关联的隐藏<label>，再配置iText的转换属性来解析标签文本：

<input type="checkbox" id="$elementId" name="cbk" value="Yes" checked/>
<label for="$elementId" style="display:none;">Yes</label>

转换时配置ConverterProperties：

ConverterProperties properties = new ConverterProperties();
properties.setFormFieldFactory(new DefaultFormFieldFactory() {
    @Override
    public PdfFormField createCheckBoxField(FormFieldProperties properties) {
        PdfFormField field = super.createCheckBoxField(properties);
        // 把关联label的文本设为导出值
        String labelText = properties.getLabel();
        if (labelText != null && !labelText.isEmpty()) {
            field.setExportValue(labelText);
        }
        return field;
    }
});
// 用配置好的properties执行转换
HtmlConverter.convertToPdf(htmlContent, pdfDocument, properties);

方式三：自定义表单字段工厂 #

实现IFormFieldFactory接口，自定义复选框字段的创建逻辑，直接把HTML里的value设为导出值：

public class CustomFormFieldFactory implements IFormFieldFactory {
    @Override
    public PdfFormField createCheckBoxField(FormFieldProperties properties) {
        PdfFormField checkBox = PdfFormField.createCheckBox(
            properties.getPdfDocument(),
            properties.getRectangle(),
            properties.getFieldName(),
            properties.getValue(),
            properties.getFont(),
            properties.getText()
        );
        // 直接将HTML中的value设置为导出值
        checkBox.setExportValue(properties.getValue());
        checkBox.setNeedAppearances(true);
        return checkBox;
    }

    // 其他表单字段类型（如文本框）的创建方法，可直接调用DefaultFormFieldFactory的实现
}

使用时在转换属性中设置自定义工厂：

ConverterProperties properties = new ConverterProperties();
properties.setFormFieldFactory(new CustomFormFieldFactory());
HtmlConverter.convertToPdf(htmlContent, pdfDocument, properties);

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