使用jsPDF生成PDF：Acroform单选按钮无法在Acrobat中取消选中

在Node.js环境中使用jsPDF生成PDF文档，按照官方Acroforms示例创建单选按钮后，Chrome、Safari等浏览器打开生成的PDF时，单选按钮可以取消选中，但在Acrobat中无法实现该操作。遵循官方示例代码仍出现此问题，相关代码如下：

var { RadioButton, Appearance } = jsPDF.AcroForm;

doc.text("RadioGroup:", 50, 165);
var radioGroup = new RadioButton();
radioGroup.value = "Test";
radioGroup.Subtype = "Form";

doc.addField(radioGroup);

var radioButton1 = radioGroup.createOption("Test");
radioButton1.Rect = [50, 170, 30, 10];
radioButton1.AS = "/Test";

var radioButton2 = radioGroup.createOption("Test2");
radioButton2.Rect = [50, 180, 30, 10];

var radioButton3 = radioGroup.createOption("Test3");
radioButton3.Rect = [50, 190, 20, 10];

radioGroup.setAppearance(Appearance.RadioButton.Cross);

原因 #

Acrobat严格遵循PDF规范：默认情况下，单选按钮组是互斥选中状态，选中某一项后无法直接取消，除非表单明确配置了允许取消选中的属性。而浏览器内置的PDF阅读器对规范的实现更宽松，支持点击已选中的单选按钮来取消选择。

解决方法 #

要让Acrobat支持取消单选按钮选中，需给单选按钮组添加NoToggleToOff属性并设置为false，明确允许取消操作。修改后的代码如下：

var { RadioButton, Appearance } = jsPDF.AcroForm;

doc.text("RadioGroup:", 50, 165);
var radioGroup = new RadioButton();
radioGroup.value = "Test";
radioGroup.Subtype = "Form";
// 启用取消选中功能
radioGroup.NoToggleToOff = false;

doc.addField(radioGroup);

var radioButton1 = radioGroup.createOption("Test");
radioButton1.Rect = [50, 170, 30, 10];
radioButton1.AS = "/Test";

var radioButton2 = radioGroup.createOption("Test2");
radioButton2.Rect = [50, 180, 30, 10];

var radioButton3 = radioGroup.createOption("Test3");
radioButton3.Rect = [50, 190, 20, 10];

radioGroup.setAppearance(Appearance.RadioButton.Cross);

补充说明 #

• NoToggleToOff是PDF规范中的标准属性，默认值为true（禁止取消选中），设置为false后，Acrobat会允许点击已选中的单选按钮取消选择
• 确保使用较新版本的jsPDF，旧版本可能不支持完整的AcroForm属性配置

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