组件功能

单选组组件，用于在多个选项中选择一个值，常见于性别、状态、类型等互斥选项的选择场景。

基础用法

通过 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

注意：

★ 标记为必填属性。