复选框 Checkbox
基本的复选框
可以自定义是否禁用复选框、自定义图标、添加边框
复选框组
利用 v3-button-group 来管理一组复选框,可以绑定 number、string、boolean 类型的值
按钮形式的复选框
indeterminate 状态
限制最大/最小选择数量
不同尺寸的复选框
API
Checkbox Props
| 参数名 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| border | 是否带有边框 | boolean | false | |
| disabled | 禁用状态 | boolean | false | |
| label | 复选框的值 | string / boolean / number | ||
| indeterminate | 是否为不确定状态 | boolean | false | |
| selectedIcon | 选中时的图标 | string | CheckCorrect | |
| indeterminatedIcon | 不确定时的图标 | string | Reduce | |
| defaultIcon | 未选中状态下的图标 | string | Square | |
| size | 复选框的尺寸 | string | small / medium / large | medium |
| modelValue | 单独使用时绑定的 v-model | boolean | false |
Checkbox Events
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| change | 值发生变化时触发 | (newValue, e: Event) |
Checkbox Slots
| 插槽名 | 说明 | 子标签 |
|---|---|---|
| default | 默认插槽 |
CheckboxGroup Props
| 参数名 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| modelValue | v-model | Array<string / boolean / number> | [] | |
| min | 限制的最小选择个数 | number / undefined | undefined | |
| max | 限制的最大选择个数 | number / undefined | undefined |
CheckboxGroup Events
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| change | 值发生变化时触发 | (newValue, e: Event) |
CheckboxGroup Slots
| 插槽名 | 说明 | 子标签 |
|---|---|---|
| default | 默认插槽 | Checkbox / CheckboxButton |
CheckboxButton Props
| 参数名 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| disabled | 是否禁用 | boolean | false | |
| label | 绑定的值 | number / string / boolean | '' | |
| size | 复选按钮的尺寸 | string | small / medium / large | medium |
CheckboxButton Events
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| change | 值发生变化时触发 | (newValue, e: Event) |
CheckboxButton Slots
| 插槽名 | 说明 | 子标签 |
|---|---|---|
| default | 默认插槽 |
