一、组件功能
单选组组件,用于在多个选项中选择一个值,常见于性别、状态、类型等互斥选项的选择场景。
二、基础用法
通过 name 与表单字段关联,options 定义可选项列表,用户在同一组内只能选择一个选项。
Template 示例:
<RadioGroup name="gender" options={[ { label: "男", value: "male" }, { label: "女", value: "female" }, { label: "其他", value: "other" } ]}/>
效果展示如下:
单选后(示例选择为“其他”),效果展示如下:
三、属性说明
| 属性名 | 类型 | 描述 | 默认值 |
| name ★ | string | 表单字段名称 | – |
| options | RadioOption[] | 选项列表 | – |
| defaultValue | string | 默认选中值 | – |
| direction | "row" | "col" | 布局方向 | "col" |
| onChangeAction | ActionConfig | 值变化时触发的动作 | – |
| disabled | boolean | 是否禁用整个组 | false |
| ariaLabel | string | 无障碍标签 | – |
| required | boolean | 是否必填 | false |
| theme | "brand" | "primary" | 主题样式 | "brand" |
四、RadioOption 对象
| 属性名 | 类型 | 描述 | 默认值 |
| label ★ | string | 选项显示文本 | – |
| value ★ | string | 选项值 | – |
| disabled | boolean | 是否禁用该选项 | false |
注意:★ 标记为必填属性。