嘿Dirk，我刚好能帮你解决这个问题！

你不需要依赖JavaScript就能实现这个需求——核心是让这3个复选框属于同一个字段组，同时给每个复选框设置不同的导出值。PDF阅读器（包括Adobe Reader）会原生处理这种字段的互斥逻辑，完美替代单选按钮的功能，还能保留复选框的外观。

用iText 7实现的代码示例 #

下面是完整的Java代码，创建3个具备单选互斥功能的复选框：

import com.itextpdf.forms.PdfAcroForm;
import com.itextpdf.forms.fields.PdfCheckBox;
import com.itextpdf.kernel.geom.Rectangle;
import com.itextpdf.kernel.pdf.PdfDocument;
import com.itextpdf.kernel.pdf.PdfWriter;
import com.itextpdf.layout.Document;
import com.itextpdf.layout.element.Paragraph;

import java.io.FileNotFoundException;

public class CheckboxAsRadio {
    public static void main(String[] args) throws FileNotFoundException {
        // 创建PDF文档
        PdfDocument pdfDoc = new PdfDocument(new PdfWriter("checkbox_radio_group.pdf"));
        Document doc = new Document(pdfDoc);

        // 获取或创建表单
        PdfAcroForm form = PdfAcroForm.getAcroForm(pdfDoc, true);

        // 定义所有复选框的共同字段名（核心：同一个字段名实现互斥）
        String groupFieldName = "myCustomRadioGroup";

        // 添加第一个复选框
        PdfCheckBox checkbox1 = new PdfCheckBox(form.getPdfDocument());
        checkbox1.setFieldName(groupFieldName);
        checkbox1.setExportValue("option_1"); // 每个选项的唯一标识
        form.addField(checkbox1, new Rectangle(100, 700, 20, 20));
        doc.add(new Paragraph("选项1").setFixedPosition(130, 700, 150));

        // 添加第二个复选框
        PdfCheckBox checkbox2 = new PdfCheckBox(form.getPdfDocument());
        checkbox2.setFieldName(groupFieldName);
        checkbox2.setExportValue("option_2");
        form.addField(checkbox2, new Rectangle(100, 670, 20, 20));
        doc.add(new Paragraph("选项2").setFixedPosition(130, 670, 150));

        // 添加第三个复选框
        PdfCheckBox checkbox3 = new PdfCheckBox(form.getPdfDocument());
        checkbox3.setFieldName(groupFieldName);
        checkbox3.setExportValue("option_3");
        form.addField(checkbox3, new Rectangle(100, 640, 20, 20));
        doc.add(new Paragraph("选项3").setFixedPosition(130, 640, 150));

        doc.close();
    }
}

关键逻辑解释 #

• 同一个字段名：所有复选框使用groupFieldName作为字段名，这是实现互斥的核心——PDF规范中，同名的复选框会自动触发单选逻辑，选中一个时自动取消其他选项。
• 不同导出值：给每个复选框设置唯一的exportValue，这样在提交表单时，你能准确判断用户选中的是哪一个选项。
• 无JS依赖：完全依赖PDF原生行为，不需要添加任何JavaScript代码，在Adobe Reader中能完美显示和工作，解决了你提到的单选按钮外观缺陷问题。

如果你在用iText 5的兼容写法 #

如果你还在使用旧版iText 5，核心逻辑不变，只是API稍有不同：

import com.itextpdf.text.Document;
import com.itextpdf.text.DocumentException;
import com.itextpdf.text.Phrase;
import com.itextpdf.text.Rectangle;
import com.itextpdf.text.pdf.*;

import java.io.FileOutputStream;
import java.io.IOException;

public class CheckboxAsRadioItext5 {
    public static void main(String[] args) throws IOException, DocumentException {
        Document document = new Document();
        PdfWriter writer = PdfWriter.getInstance(document, new FileOutputStream("checkbox_radio_group_itext5.pdf"));
        document.open();

        PdfAcroForm form = writer.getAcroForm();
        String groupFieldName = "myCustomRadioGroup";

        // 选项1
        CheckboxField checkbox1 = new CheckboxField(writer, new Rectangle(100, 700, 120, 720), groupFieldName);
        checkbox1.setCheckType(CheckboxField.TYPE_CHECK);
        checkbox1.setExportValue("option_1");
        form.addField(checkbox1.getField());
        document.add(new Phrase(12, "选项1")).setAbsolutePosition(130, 705);

        // 选项2
        CheckboxField checkbox2 = new CheckboxField(writer, new Rectangle(100, 670, 120, 690), groupFieldName);
        checkbox2.setCheckType(CheckboxField.TYPE_CHECK);
        checkbox2.setExportValue("option_2");
        form.addField(checkbox2.getField());
        document.add(new Phrase(12, "选项2")).setAbsolutePosition(130, 675);

        // 选项3
        CheckboxField checkbox3 = new CheckboxField(writer, new Rectangle(100, 640, 120, 660), groupFieldName);
        checkbox3.setCheckType(CheckboxField.TYPE_CHECK);
        checkbox3.setExportValue("option_3");
        form.addField(checkbox3.getField());
        document.add(new Phrase(12, "选项3")).setAbsolutePosition(130, 645);

        document.close();
    }
}

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