Checkbox 多选框
一组备选项中进行多选
基础用法
单独使用可以表示两种状态之间的切换。
禁用状态
多选框不可用状态。
多选框组
适用于多个勾选框绑定到同一个数组的情景,通过是否勾选来表示这一组选项中的项。
indeterminate状态
indeterminate
属性用以表示checkbox的不确定状态,一般用于实现全选的效果
可选项目数量的限制
使用 min
和 max
属性能够限制可以被勾选的项目的数量。
按钮样式
按钮样式的多选组合。
Checkbox Attributes
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
label | 选中状态的值(只有在Checkbox.Group 或者绑定对象类型为array 时有效) | string | — | — |
trueLabel | 选中时的值 | string, number | — | — |
falseLabel | 没有选中时的值 | string, number | — | — |
disabled | 按钮禁用 | boolean | — | false |
checked | 当前是否勾选 | boolean | — | false |
indeterminate | 设置 indeterminate 状态,只负责样式控制 | boolean | — | false |
Checkbox.Group Attributes
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
value | 指定选中的选项 | string[] | - | [] |
size | Checkbox 按钮组尺寸 | string | large, small | — |
fill | 按钮激活时的填充色和边框色 | string | — | #20a0ff |
textColor | 按钮激活时的文本颜色 | string | — | #ffffff |
min | 可被勾选的 checkbox 的最大数量 | number | — | — |
max | 可被勾选的 checkbox 的最小数量 | number | — | — |
Checkbox.Group Events
事件名称 | 说明 | 回调参数 |
---|---|---|
onChange | 当绑定值变化时触发的事件 | value |