DocuSign中勾选单个复选框后全部复选框被选中的问题解决

我用C#结合DocuSign API生成需要用户签署的PDF文档，在模板里实现了21个复选框，每个复选框的容器HTML示例如下：

<div style="width: 30px; height: 30px; align-self: center; border-radius: 15px; border: #565F58 1px solid; background-color: #fff;">/cb21/</div>

所有复选框的锚点字符串以/cb/开头，后跟1-21的数字，保证唯一。我用以下代码循环创建这些复选框：

List<Checkbox> checkBoxes = new List<Checkbox>();

for (int index = 1; index <= 21; index++)
{
  var clickCheckboxHere = new Checkbox
  {
    AnchorString = $"/cb{index}/",
    AnchorUnits = "pixels",
    AnchorYOffset = "",
    AnchorXOffset = "",
    TabGroupLabels = new List<string>() { $"checkBox{index}" },
    Shared = "false",
  };

  checkBoxes.Add(clickCheckboxHere);
}

模板中视觉上所有复选框都是分散显示的，但现在出现问题：点击任意一个复选框时，所有21个复选框都会被选中。请问怎么实现点击仅选中当前复选框？

解决办法 #

核心问题是未给每个Checkbox设置唯一的TabLabel属性。DocuSign依赖TabLabel来区分不同的表单控件，如果不指定，系统可能自动生成重复的标识，导致多个复选框被关联成一组，出现点击一个全选的情况。

修改代码，给每个Checkbox添加唯一的TabLabel：

List<Checkbox> checkBoxes = new List<Checkbox>();

for (int index = 1; index <= 21; index++)
{
  var clickCheckboxHere = new Checkbox
  {
    AnchorString = $"/cb{index}/",
    AnchorUnits = "pixels",
    AnchorYOffset = "",
    AnchorXOffset = "",
    TabLabel = $"checkbox_tab_{index}", // 添加唯一的TabLabel
    TabGroupLabels = new List<string>() { $"checkBox{index}" },
    Shared = "false",
  };

  checkBoxes.Add(clickCheckboxHere);
}

额外排查要点 #

• 确认模板中所有/cb{index}/锚点字符串完全唯一，没有拼写重复或错误
• 检查复选框定位：如果AnchorX/YOffset为空，确保锚点文本的位置不会导致多个Checkbox实际定位重叠（视觉分开但位置重叠也会触发联动）
• 确保Shared属性保持为"false"，避免控件被设置为共享状态

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