## Checkbox A group of options for multiple choices. ### Basic usage Checkbox can be used alone to switch between two states. :::demo Define `v-model`(bind variable) in `el-checkbox`. The default value is a `Boolean` for single `checkbox`, and it becomes `true` when selected. ```html ``` ::: ## Disabled State Disabled state for checkbox. ::: demo Set the `disabled` attribute. ```html ``` ::: ### Checkbox group It is used for multiple checkboxes which are bound in one group, and indicates whether one option is selected by checking if it is checked. :::demo `checkbox-group` element can manage multiple checkboxes in one group by using `v-model` which is bound as an `Array`. `label` can modify the description following the button of the checkbox. It is also the value of the checkbox. `label` corresponds with the element values in the array. It is selected if the specified value exists in the array, and vice versa. ```html ``` ::: ### Checkbox Attributes | Attribute | Description | Type | Options | Default| |---------- |-------- |---------- |------------- |-------- | | label | value of the checkbox when used inside a `checkbox-group` | string | — | — | | true-label | value of the checkbox if it's checked | string, number | — | — | | false-label | value of the checkbox if it's not checked | string, number | — | — | | name | native 'name' attribute | string | — | — | | disabled | if the checkbox is disabled | boolean | — | false | | checked | if the checkbox is checked | boolean | — | false | | indeterminate | same as `indeterminate` in native checkbox | boolean | — | false | ### Checkbox-group Events | Event Name | Description | Parameters | |---------- |-------- |---------- | | change | triggers when the binding value changes | Event object |