跳到主要内容
版本:3.x

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
namestringCheckbox 的名字
nativePropsRecord<string, unknown>用于透传 WebComponents 上的属性到内部 H5 标签上
ariaLabelstring无障碍访问,(属性)元素的额外描述
onChangeCommonEventFunction<{ value: string[]; }>选中项发生变化时触发 change 事件,小程序无此 API

API 支持度

API微信小程序百度小程序支付宝小程序抖音小程序QQ 小程序京东小程序H5React NativeHarmonyHarmony hybrid
CheckboxProps.value✔️✔️✔️✔️✔️✔️✔️✔️✔️
CheckboxProps.disabled✔️✔️✔️✔️✔️✔️✔️✔️✔️
CheckboxProps.checked✔️✔️✔️✔️✔️✔️✔️✔️✔️
CheckboxProps.color✔️✔️✔️✔️✔️✔️✔️✔️✔️
CheckboxProps.name✔️✔️✔️
CheckboxProps.nativeProps✔️✔️
CheckboxProps.ariaLabel✔️
CheckboxProps.onChange✔️✔️✔️✔️