组件功能
单选组组件,用于在多个选项中选择一个值,常见于性别、状态、类型等互斥选项的选择场景。
基础用法
通过 name 与表单字段关联,options 定义可选项列表,用户在同一组内只能选择一个选项。
Template 示例:
<RadioGroupname="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 |
注意:
★ 标记为必填属性。