单选是用来在一组平铺选项中选择目标选项,每次只选一个
需要快速完成多选一且备选项数量不多时
常见于后台设置、调研问卷等场景
参数 |
说明 |
类型 |
可选值 |
默认值 |
data |
选择项数据源 |
DataItem[] |
- |
- |
placement |
设置水平或垂直展示 |
string |
'vertical' | 'horizontal' |
'horizontal' |
value |
选中项的值(受控) |
string | number |
- |
- |
defaultValue |
默认选中项的值 |
string | number |
- |
- |
disabled |
是否禁用 |
boolean |
- |
- |
type |
单选按展示形状 |
string |
'default' | 'button' |
'default' |
name |
RadioGroup 下透传给所有 Radio 的 name 属性 |
string |
- |
- |
参数 |
说明 |
类型 |
可选值 |
默认值 |
value |
单选对应的值 |
string |
- |
- |
autoFocus |
是否自动获取焦点 |
boolean |
true | false |
false |
disabled |
是否禁用 |
boolean |
- |
- |
checked |
是否选中 |
boolean |
true | false |
false |
defaultChecked |
是否默认选中 |
boolean |
true | false |
false |
readOnly |
是否只读 |
boolean |
true | false |
false |
名称 |
说明 |
类型 |
参数 |
返回值 |
onChange |
变化时的回调 |
(event: React.ChangeEvent<HTMLInputElement>) => void |
event: input 事件对象 |
- |
名称 |
说明 |
类型 |
参数 |
返回值 |
onChange |
选中项改变时的回调 |
(value: string) => void |
value: 选中项 ID |
- |
参数 |
说明 |
类型 |
可选值 |
默认值 |
id |
选择项对应的值 |
string |
- |
- |
content |
选择项的展示内容 |
ReactText |
- |
- |
disabled |
是否禁用 |
boolean |
true | false |
false |
参数 |
变更类型 |
变更内容 |
解决的问题 |
propName |
feature | deprecated | update |
变更了什么 |
之前是什么样子,解决什么问题 |
---- |
---- |
---- |
---- |
children |
feature |
RadioGroup 支持内嵌 Radio |
实现灵活的布局 |
content |
feature |
类型:string -> ReactNode |
1. 强化类型支持 |
readOnly |
feature |
- |
1. 强化 Radio 功能支持 |