使用场景:单选按钮允许用户从一个数据集中选择单个选项。如果你觉得用户需要并排看到所有的可选项,使用单选按钮进行排他操作。
调用 Radio 组件,checked 属性可以设置 radio 是否选中,或者 defaultChecked 属性设置默认选中。使用 disabled 设置 radio 是否可操作。
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
id | 组件input的id | String | - |
checked | 设置radio是否选中 | Boolean | - |
defaultChecked | 设置radio是否默认选中 | Boolean | - |
label | 通过属性配置label | ReactNode | - |
onChange | 状态变化时触发的事件 签名: Function(checked: Boolean, e: Event) => void 参数: checked: {Boolean} 是否选中 e: {Event} Dom 事件对象 | Function | func.noop |
onMouseEnter | 鼠标进入enter事件 签名: Function(e: Event) => void 参数: e: {Event} Dom 事件对象 | Function | func.noop |
onMouseLeave | 鼠标离开事件 签名: Function(e: Event) => void 参数: e: {Event} Dom 事件对象 | Function | func.noop |
disabled | radio是否被禁用 | Boolean | - |
value | radio 的value | String/Number/Boolean | - |
name | name | String | - |
isPreview | 是否为预览态 | Boolean | false |
renderPreview | 预览态模式下渲染的内容 签名: Function(value: number) => void 参数: value: {number} 评分值 | Function | - |
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
name | name | String | - |
size | 与 shape 属性配套使用,shape设为button时有效可选值: 'large'(大) 'medium'(中) 'small'(小) | Enum | 'medium' |
shape | 可以设置成 button 展示形状 可选值: 'normal'(按钮状) 'button' | Enum | - |
value | radio group的选中项的值 | String/Number/Boolean | - |
defaultValue | radio group的默认值 | String/Number/Boolean | - |
component | 设置标签类型 | String/Function | 'div' |
onChange | 选中值改变时的事件 签名: Function(value: String/Number, e: Event) => void 参数: value: {String/Number} 选中项的值 e: {Event} Dom 事件对象 | Function | () => {} |
disabled | 表示radio被禁用 | Boolean | - |
dataSource | 可选项列表, 数据项可为 String 或者 Object, 如 ['apple', 'pear', 'orange'] [{label: 'apply', value: 'apple'}] | Array<String>/Array<Object> | [] |
children | 通过子元素方式设置内部radio | Array<ReactElement>/ReactElement | - |
itemDirection | 子项目的排列方式 - hoz: 水平排列 (default) - ver: 垂直排列 可选值: 'hoz', 'ver' | Enum | 'hoz' |
isPreview | 是否为预览态 | Boolean | false |
renderPreview | 预览态模式下渲染的内容 签名: Function(value: number) => void 参数: value: {number} 评分值 | Function | - |
shape 属性设置为 button 时,单选按钮显示类似于 button 的样子,这时 可以 使用 size 属性设置其尺寸。