腾讯云智能体开发平台 RadioGroup 单选组

这篇说说单选组组件的功能、基础用法及属性配置,用于在互斥选项中选择一个值,支持通过name、options等属性实现表单关联和自定义布局。 基础用法:通过name绑定表单字段,options定义选项列表,用户只能单选。 属性说明:包括name、options、defaultValue、direction等,支持布局方向、禁用、必填等配置。 RadioOption对象:包含label、value和disabled属性。

相关产品
腾讯云智能体开发平台 产品页,含版本规格、价格与购买入口。

一、组件功能

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

二、基础用法

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

注意:★ 标记为必填属性。

赞 (0)
上一篇 4天前
下一篇 4天前