Skip to main content

Checkbox

Effect demonstration

1. Default effect

<Checkbox
options={[
{ label: "Apple", value: "Apple" },
{ label: "Pear", value: "Pear" },
{ label: "Orange", value: "Orange" },
]}
/>
card-ios1

2. A checkbox is selected by default

<Checkbox
options={[
{ label: "Apple", value: "Apple" },
{ label: "Pear", value: "Pear" },
{ label: "Orange", value: "Orange" },
]}
defaultValue={["Pear"]}
/>
card-ios1

3. Do not display select all

<Checkbox
options={[
{ label: "Apple", value: "Apple" },
{ label: "Pear", value: "Pear" },
{ label: "Orange", value: "Orange" },
]}
showCheckAll={false}
/>
card-ios1

4. Disable a checkbox

<Checkbox
options={[
{ label: "Apple", value: "Apple" },
{ label: "Pear", value: "Pear" },
{ label: "Orange", value: "Orange" },
]}
disabledValue={["Pear"]}
/>
card-ios1

5. Checkbox list

<Checkbox.CheckboxList
options={[
{ label: "Apple", value: "Apple" },
{ label: "Pear", value: "Pear" },
{ label: "Orange", value: "Orange" },
]}
/>
card-ios1

API

Checkbox /CheckboxList

PropertiesRequiredDescriptionTypeDefault Value
optionstrueSpecify optionsRadioOption[]
valuefalseselected itemReactText[]
onChangefalseThe callback function triggered by selecting the radio button(value: ReactText[]) => void
defaultValuefalseDefault selected itemsReactText[]
sizefalseicon sizenumber
disabledValuefalseSet disabled itemsReactText[]
containerStylefalseCustom container styleViewStyle
itemStylefalseCustomize the style of a single radio buttonViewStyle
labelStylefalseCustom text styleTextStyle
showCheckAllfalseWhether to display the select boxbooleantrue
activeOpacityfalseOpacity when not disablednumber0.6

CheckboxItem

PropertiesRequiredDescriptionTypeDefault Value
itemStylefalseCustomize the style of a single radio buttonViewStyle
labelStylefalseCustom text styleTextStyle
sizefalseicon sizenumber
labeltrueradio button textReactNode
valuetrueThe value of the radio buttonReactText
statustrueRadio button checked status'checked' | 'unchecked' | 'halfchecked'
disabledtrueRadio button disabled stateboolean
modefalseRadio button mode, list means display in a list'list' | 'row'
onChangefalseThe callback function triggered by selecting the radio button(value: ReactText, status: RadioStatus) => void