单选框

1. 组件概述

单选框是一个数据输入组件，用于在多个互斥选项中选择一个。它以单选按钮列表的形式展示所有选项，用户只能选中其中一个选项。单选框适用于选项数量较少、需要用户明确做出单一选择的场景，如性别选择、难度级别选择、答题选项等。

加载中...

查看 JSON

复制 JSON

2. 应用场景示例

• 场景一：答题应用中的选择题。在知识问答或测验类应用中，使用单选框展示题目的各个选项（如 A、B、C、D），用户选择答案后，在”值变化”事件中调用工作流，将用户的选择传递给后端进行判题和反馈。
• 场景二：AI 对话风格选择。在 AI 助手应用中，让用户选择对话风格（如”正式”、“轻松”、“幽默”），选中后通过变量传递给工作流，AI 根据所选风格调整回复语气。

加载中...

查看 JSON

复制 JSON

3. 功能配置

基础

配置折叠组

配置项	说明
绑定变量	组件的变量名，用户选中的值会存储到该变量中。其他组件可以绑定此变量来获取选中值，调用工作流时此变量的值也会传递给工作流。
标题	单选框左侧显示的标签文字，用于说明该选择项的用途，如”性别”、“难度”、“答案”等。
默认值	页面加载时默认选中的选项。可以从已配置的选项中选择一个作为默认值，也可以绑定变量动态设置。只有在配置了选项后才会显示此配置项。
标题提示	在标题旁边显示一个小问号图标，鼠标悬停时弹出提示内容。适合放置对该选择项的补充说明。
控件提示	在单选框控件旁边显示一个小问号图标，鼠标悬停时弹出提示内容。

选项折叠组

配置项	说明
数据	配置单选框的选项列表。可以手动添加选项（每个选项包含显示文本和对应的值），也可以通过接口动态获取选项数据。
默认选择第一项	开启后，页面加载时会自动选中第一个选项。适用于希望用户必须做出选择、且第一个选项是合理默认值的场景。

事件折叠组

配置项	说明
添加事件	支持”值变化”事件，当用户选择不同选项时触发。常见用法是在值变化时调用工作流，将用户的选择传递给后端处理，或者根据选择动态控制其他组件的显示。

设计

表单项折叠组

配置项	说明
一行选项显示	控制所有选项是否在同一行内水平排列。开启时选项横向排列，关闭时选项纵向排列（每个选项占一行）。默认开启。
每行选项个数	当关闭”一行选项显示”后出现此配置。设置每行显示的选项数量，范围为 1-6 个。适用于选项较多时进行分行排列。
模式	选项的视觉样式。可选”默认”（传统单选按钮样式）或”按钮”（选项以按钮形式展示，选中时按钮高亮）。按钮模式视觉上更醒目，适合重要选择场景。

选项样式折叠组

配置项	说明
选项样式	自定义选项文字的样式，包括字体、背景、边框等。支持分别设置常规、悬浮、禁用、选中、选中悬浮、选中禁用六种状态下的样式。

单选框样式折叠组

配置项	说明
隐藏勾选框	开启后隐藏选项前面的圆形单选按钮图标，只显示选项文字。适用于希望简化视觉效果的场景。此配置仅在”默认”模式下有效。
单选框样式	自定义单选按钮圆圈的样式，包括背景色、边框等。支持分别设置常规、悬浮、禁用、选中、选中悬浮、选中禁用六种状态。选中状态下还可以自定义圆圈内的图标和图标颜色。

高级

状态折叠组

配置项	说明
可见	控制组件是否显示。默认可见，可以设置为始终隐藏或根据条件动态控制。
隐藏	控制组件是否隐藏。与”可见”相反。
禁用	控制组件是否禁用。禁用后选项变灰且不可点击。可以设置为始终禁用或根据条件动态控制，例如在用户未完成前置步骤时禁用选择。
静态展示	开启后，单选框变为只读的纯文本展示模式，显示当前选中的选项文字，不可编辑。适用于详情页或确认页面。

校验折叠组

配置项	说明
校验规则	配置表单校验规则，如必填等。开启必填后，用户必须选择一个选项才能提交表单。