使用DocuSign REST API时单选按钮标题不显示问题排查

问题出在DocuSign的API设计上：单选按钮的caption属性并非用于显示按钮旁的文本，这个属性在实际使用中不会渲染出可见的标题。而value确实只是鼠标悬停时的提示文本，不是按钮的显示标签。

要给单选按钮添加显示标题，你需要单独添加只读文本标签（Text Tab），和对应的单选按钮位置关联，具体步骤如下：

1. 移除无效的caption属性（它不会起作用）
2. 为每个单选按钮添加一个文本标签，设置好对齐的位置（通常在按钮右侧），并将文本标签设为只读

修改后的完整示例代码：

"tabs": {
    "radioGroupTabs": [
        {
            "documentId": 66,
            "groupName": "bill",
            "recipientId": "2",
            "tabLabel": "bill",
            "radios": [
                {
                    "pageNumber": 4,
                    "xPosition": 125,
                    "yPosition": 524,
                    "value": "Radio1"
                },
                {
                    "pageNumber": 4,
                    "xPosition": 126,
                    "yPosition": 544,
                    "value": "Radio2"
                }
            ]
        }
    ],
    "textTabs": [
        {
            "documentId": 66,
            "pageNumber": 4,
            "xPosition": 150, // 调整到单选按钮右侧合适位置，可根据实际需求修改
            "yPosition": 520,
            "recipientId": "2",
            "value": "Radio1",
            "readOnly": true
        },
        {
            "documentId": 66,
            "pageNumber": 4,
            "xPosition": 150,
            "yPosition": 540,
            "recipientId": "2",
            "value": "Radio2",
            "readOnly": true
        }
    ]
}

注意事项：

• 调整文本标签的xPosition和yPosition，确保和对应的单选按钮对齐，视觉上连贯
• 必须将文本标签设为readOnly: true，避免用户编辑标题文本
• DocuSign的单选按钮控件本身仅提供选择功能，显示文本需要通过独立的文本标签实现，这是API的既定逻辑

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