Checkbox 复选框

使用场景:复选框允许用户从一个数据集中选择多个选项。

基本

Checkbox 组件使用,分 label 和无 label 两种情况。defaultChecked 属性默认选中,checked 属性选中,disabled 属性不可操作,defaultIndeterminate 属性设置半选状态。

Loading demo...

APIs

Checkbox

参数说明类型默认值
idcheckbox id, 挂载在input上String-
checked选中状态Boolean-
defaultChecked默认选中状态Booleanfalse
disabled禁用Boolean-
label通过属性配置label,ReactNode-
indeterminateCheckbox 的中间状态,只会影响到 Checkbox 的样式,并不影响其 checked 属性Boolean-
defaultIndeterminateCheckbox 的默认中间态,只会影响到 Checkbox 的样式,并不影响其 checked 属性Booleanfalse
onChange状态变化时触发的事件

签名:
Function(checked: Boolean, e: Event) => void
参数:
checked: {Boolean} 是否选中
e: {Event} Dom 事件对象
Functionfunc.noop
onMouseEnter鼠标进入enter事件

签名:
Function(e: Event) => void
参数:
e: {Event} Dom 事件对象
Functionfunc.noop
onMouseLeave鼠标离开Leave事件

签名:
Function(e: Event) => void
参数:
e: {Event} Dom 事件对象
Functionfunc.noop
valuecheckbox 的valueString/Number-
namenameString-
isPreview是否为预览态Booleanfalse
renderPreview预览态模式下渲染的内容

签名:
Function(value: number) => void
参数:
value: {number} 评分值
Function-

Checkbox.Group

参数说明类型默认值
disabled整体禁用Boolean-
dataSource可选项列表, 数据项可为 String 或者 Object, 如 ['apple', 'pear', 'orange'] 或者 [{value: 'apple', label: '苹果',}, {value: 'pear', label: '梨'}, {value: 'orange', label: '橙子'}]Array<String>/Array<Object>[]
value被选中的值列表Array/String/Number-
defaultValue默认被选中的值列表Array/String/Number-
children通过子元素方式设置内部 checkboxArray<ReactElement>-
onChange选中值改变时的事件

签名:
Function(value: Array, e: Event) => void
参数:
value: {Array} 选中项列表
e: {Event} Dom 事件对象
Function() => {}
itemDirection子项目的排列方式
- hoz: 水平排列 (default)
- ver: 垂直排列

可选值:
'hoz', 'ver'
Enum'hoz'
isPreview是否为预览态Booleanfalse
renderPreview预览态模式下渲染的内容

签名:
Function(value: number) => void
参数:
value: {number} 评分值
Function-

Demo

中间状态组件

Loading demo...

受限组件

Loading demo...

非受限组件

Loading demo...

Checkbox嵌套使用

Loading demo...