Skip to main content
Version: 下个版本

Checkbox

多选项目

支持情况:

参考文档

类型

ComponentType<CheckboxProps>

示例代码

export default class PageCheckbox extends Component {
state = {
list: [
{
value: '美国',
text: '美国',
checked: false
},
{
value: '中国',
text: '中国',
checked: true
},
{
value: '巴西',
text: '巴西',
checked: false
},
{
value: '日本',
text: '日本',
checked: false
},
{
value: '英国',
text: '英国',
checked: false
},
{
value: '法国',
text: '法国',
checked: false
}
]
}
render () {
return (
<View className='page-body'>
<View className='page-section'>
<Text>默认样式</Text>
<Checkbox value='选中' checked>选中</Checkbox>
<Checkbox style='margin-left: 20rpx' value='未选中'>未选中</Checkbox>
</View>
<View className='page-section'>
<Text>推荐展示样式</Text>
{this.state.list.map((item, i) => {
return (
<Label className='checkbox-list__label' for={i} key={i}>
<Checkbox className='checkbox-list__checkbox' value={item.value} checked={item.checked}>{item.text}</Checkbox>
</Label>
)
})}
</View>
</View>
)
}
}

CheckboxProps

参数类型默认值必填说明
valuestring<Checkbox/>标识,选中时触发<CheckboxGroup/>的 change 事件,并携带 <Checkbox/> 的 value
disabledbooleanfalse是否禁用
checkedbooleanfalse当前是否选中,可用来设置默认选中
colorstringcheckbox的颜色,同 css 的 color
onChangeCommonEventFunction<{ value: string[]; }>选中项发生变化时触发 change 事件,小程序无此 API
nativePropsRecord<string, unknown>用于透传 WebComponents 上的属性到内部 H5 标签上

API 支持度

API微信小程序H5React Native
CheckboxProps.value✔️✔️
CheckboxProps.disabled✔️✔️✔️
CheckboxProps.checked✔️✔️✔️
CheckboxProps.color✔️✔️✔️
CheckboxProps.onChange✔️✔️
CheckboxProps.nativeProps✔️