复选框 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 | 默认插槽 |