在 GOV.UK Design System 中,Radios 组件的 Nunjucks 宏提供了多种选项以自定义外观、内容和行为。核心配置项包括:

1. **fieldset**(对象类型):用于定义单选框组件所属的字段集,具体参数需参考 fieldset 宏选项。
2. **hint**(对象类型):可添加提示文本或 HTML 内容至组件上方,支持通过 text 或 html 属性设置,若提供 html 则忽略 text。
3. **errorMessage**(对象类型):用于显示错误信息。若传入 falsy 值(如 false 或 null),错误消息将不显示。

此外,**formGroup** 选项允许为包含单选框的表单组添加额外配置,如 classes、attributes 以及 beforeInputs/afterInputs 内容块。items 数组是必需项,每个元素需包含 text/html、value 等属性,并支持 label、hint、divider 等子选项。

关于 HTML 清理:若在生产环境中使用带有"html"后缀的选项(如 items.html、hint.html、formGroup.beforeInputs.html 等),必须对用户提供的 HTML 内容进行清理,以防止跨站脚本攻击(XSS)。系统文档未指定具体清理库,但强调这是强制要求。开发者应在渲染前对 html 属性值进行标准化处理,确保仅保留安全标签和属性。

所有选项均支持通过 idPrefix 统一生成 ID,或通过 value 设置默认选中项。disabled、checked 等布尔选项可直接控制交互状态。

信息来源