单选按钮是PDF 表单中提供的核心输入控件之一。当添加到可填写文档时，它们为用户提供了一种清晰的方法，可以从一组互斥的选项中准确选择一个选项。常见的示例包括选择付款方式、选择运送速度、回答是或否问题或在反馈表上选择满意度评级。
向 PDF 表单添加单选按钮与添加文本字段所需的工作量大致相同，但正确分组才是功能表单与令人困惑的表单的区别所在。当单选按钮共享相同的组名称时，选择一个单选按钮会自动取消选择该组中的所有其他单选按钮。当它们具有不同的名称时，它们表现为独立的复选框，这几乎不是您想要的单选题。本指南涵盖了 Adobe Acrobat Pro、在线编辑器和WukongPDF的步骤，以及新手表单作者经常错过的配置详细信息。
WukongPDF 的可填充 PDF 编辑器将所有表单控件（包括单选按钮、复选框、文本字段和下拉菜单）放置在单个工具栏中，无需下载或安装软件即可访问。添加单选按钮后，保存表单即可分发。
单选按钮与复选框与下拉菜单
了解这三种字段类型之间的差异可以防止最常见的表单设计错误：在单选按钮所属的位置使用复选框。单选按钮强制指定组内的相互排他性。复选框是独立的；选中其中一个复选框不会影响任何其他复选框。下拉菜单也强制执行单选，但使用紧凑的列表格式。
| 单选按钮 | 复选框 | 下拉菜单 |
|---|---|---|
| 从一组中选择一个 | 多种选择，独立 | 单项选择，紧凑列表 |
| 按字段名称分组 | 每个盒子都是独立的 | 一个字段中的所有项目 |
| 最适合 2-5 个选项 | 最适合是/否或多选 | 最适合 4 个以上选项 |
当所有选项需要同时可见并且用户必须准确选择一个时，请使用单选按钮。当选项超过五个且屏幕空间有限时，请使用下拉菜单。当用户可以独立选择任意数量的选项（包括零）时，请使用复选框。
在 Adobe Acrobat Pro 中添加单选按钮
在 Acrobat Pro 中打开 PDF 并导航至“工具”，然后导航至“准备表单”。 Acrobat 扫描文档以查找表单字段候选项并建议展示位置。对于手动放置，请单击工具栏中显示为小圆圈的单选按钮图标。单击要显示第一个单选按钮的页面。分配了一个默认名称，如 Group1。
接下来是关键的一步。对于同一组中的第二个单选按钮，您必须为其指定与第一个单选按钮完全相同的字段名称。如果第一个按钮名为 PaymentMethod，则该组中的每个后续单选按钮也必须命名为 PaymentMethod。 Acrobat 将提示您警告：您已创建一个同名的单选按钮。选择是，我希望具有此名称的所有单选按钮共享单个值集。此确认会激活互斥行为。如果您不小心给第二个按钮起了不同的名称，则这两个按钮将用作独立的切换按钮，而不是链接的单选按钮。
将所有按钮放入组中后，双击任意按钮以打开“属性”对话框。在选项选项卡下，为组中的每个按钮分配唯一的按钮值，例如信用卡、PayPal 或银行转账。该导出值出现在导出的表单数据中。在“外观”选项卡下，为所有按钮设置一致的字体大小和边框样式。保存 PDF 并通过单击每个按钮来测试该组。一次只能填充一个。
使用在线 PDF 编辑器添加单选按钮
在线 PDF 编辑器通过自动对共享相同名称的按钮进行分组来简化单选按钮工作流程。上传PDF后，选择单选按钮工具，然后单击页面放置第一个选项。在右侧打开的属性面板中，键入组名称和该特定按钮的选择值。放置下一个单选按钮，为其分配相同的组名称，并为其指定不同的选择值。
大多数在线编辑器在字段列表中显示单选按钮，并带有可扩展的树视图，显示组名称和嵌套在下面的每个单独的选择。这种视觉反馈可以轻松确认所有预期按钮属于同一组。如果按钮出现在树外部，请将其拖到字段列表中的正确组中。放置所有按钮后，下载完成的 PDF 并在阅读器中测试组行为。
设置默认选择和样式选项
单选按钮可以在表单打开时加载一个预先选择的选项。在“属性”对话框的“选项”选项卡下，通过选择某个选项并单击“默认”按钮，将其设置为默认值。加载表单时，预选选项将显示为已填充。当一种选择适用于大多数用户时使用此选项，例如当大多数客户选择标准运输时预先选择它。不要预先选择同意问题或法律协议的选项；这些必须始终需要明确的用户操作。
单选按钮的大多数视觉外观对于可用性都很重要。默认外观（选择时为实心填充的小圆圈）在白色背景上效果很好，但在彩色表单部分上可能很难看到。在“外观”选项卡中，您可以更改按钮的边框颜色和填充颜色以提高对比度。为了实现可访问性，请确保单选按钮圆圈的直径至少为 11 磅，并且与页面背景具有足够的颜色对比度，如 WCAG 2.1 SC 1.4.11 所建议。
常见陷阱以及如何避免
在实践中，最常见的错误是创建具有不同字段名称的单选按钮并期望它们作为一个组工作。放置所有按钮后，打开“字段”面板并扫描列表。组中的所有按钮必须共享完全相同的名称，仅其各自的选择值有所不同。如果您看到 PaymentMethod、PaymentMethod1 和 PaymentMethod2 作为单独的字段名称，请删除后两个并使用正确的共享名称重新创建它们。
当表单作者复制并粘贴单选按钮以创建其他选项时，会出现另一个问题。复制会复制选择值以及字段名称，这意味着所有粘贴的按钮在导出的数据中报告相同的值。始终更改每个单选按钮实例的选择值，即使字段名称是共享的。如果您的表单将在移动设备上完成，请测试手机屏幕上的单选按钮间距。距离太近的按钮很难用指尖准确地点击。单选按钮行之间至少留出 24 像素的垂直空间，以适应触摸输入。
单选按钮将原本模棱两可的问题转变为清晰、结构化的数据点。通过将它们正确分组在共享名称下并为每个选择分配唯一的导出值，您可以生成直接导入到数据库和电子表格中的表单数据，而无需手动清理。
添加单选按钮以实现辅助功能合规性
可访问的单选按钮组可帮助依赖屏幕阅读器、键盘导航或高对比度模式的用户与表单正确交互。组中的每个单选按钮都应该有一个工具提示，描述组名称和特定选择。在 Acrobat Pro 中，打开字段属性，转到常规选项卡，然后在工具提示字段中填写文本，如选择您的付款方式：信用卡。当用户使用 Tab 键进入该字段时，屏幕阅读器会宣布工具提示。
单选按钮组的 Tab 键顺序应按顺序在每个选项中移动。用户通过 Tab 键进入组后，他们应该能够使用箭头键更改组内的选择，然后按 Tab 退出组并移至下一个字段。这是 PDF 规范定义的标准键盘行为，并受到所有主要屏幕阅读器的支持。在最终确定表单之前测试键盘导航流程。如果在单选组内按 Tab 键跳到下一个字段而不是在单选选项之间移动，请检查组内的单选按钮是否共享完全相同的字段名称。
对于 WCAG 2.1 AA 级下的高对比度要求，请确保单选按钮边框颜色与页面背景的对比度至少为 3:1。白色背景上的默认黑色边框符合此要求，但灰色或有色表单背景上的自定义颜色边框可能不符合此要求。在表单屏幕截图上使用对比检查工具，在分发之前验证合规性。
正确导出单选按钮值
单选按钮组将其选定的值导出为表单数据导出中的单个字段。如果用户从 PaymentMethod 组中选择 CreditCard，则导出的 CSV 或 XML 记录 PaymentMethod=CreditCard。使用的导出值是您在字段属性中分配的按钮值，而不是可见标签。要验证导出的数据中将显示哪些值，请打开一个测试表单，进行选择，导出数据，然后检查这些值是否与数据库或电子表格期望的值匹配。
当单选按钮选择值包含空格、特殊字符或大小写不一致时，会出现常见的数据集成问题。以camelCase 或snake_case 标准化选择值，例如creditCard 或credit_card，而不是Credit Card。一致的格式可防止 CSV 解析错误并使数据库字段验证更简单。在表单的设计说明中记录按钮值命名约定，以便以后维护表单的任何人都遵循相同的模式。