Skip to main content
Version: 3.x

CheckboxGroup

Multi-item picker, consisting of multiple checkbox components.

Reference

Type

ComponentType<CheckboxGroupProps>

Examples

export default class PageCheckbox extends Component {
state = {
list: [
{
value: 'A',
text: 'A',
checked: false
},
{
value: 'B',
text: 'B',
checked: true
},
{
value: 'C',
text: 'C',
checked: false
},
{
value: 'D',
text: 'D',
checked: false
},
{
value: 'E',
text: 'E',
checked: false
},
{
value: 'F',
text: 'E',
checked: false
}
]
}
render () {
return (
<View className='page-body'>
<View className='page-section'>
<Text>default style</Text>
<Checkbox value='selected' checked>Selected</Checkbox>
<Checkbox style='margin-left: 20rpx' value='not-selected'>Not Selected</Checkbox>
</View>
<View className='page-section'>
<Text>recommended style</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>
)
}
}

CheckboxGroupProps

PropertyTypeRequiredDescription
namestringNoThe name is added to the form component as a key
onChangeBaseEventOrigFunction<{ value: string[]; }>NoThe change event is triggered when the selected item in <CheckboxGroup/>is changed.

event.detail = { value: [An array of the values of the selected checkboxes.] }

Property Support

PropertyWeChat Mini-ProgramH5React Native
CheckboxGroupProps.name✔️
CheckboxGroupProps.onChange✔️✔️✔️

API Support

APIWeChat Mini-ProgramH5React Native
CheckboxGroup✔️✔️✔️