RadioGroup 单选组

最近更新时间:2025-12-31 16:49:32

我的收藏

组件功能

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

基础用法

通过 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
注意:
★ 标记为必填属性。