CheckBox 多选框
一组备选项中进行多选
何时使用
在一组选项中进行多项选择;
单独使用可以表示两种状态之间的切换,写在标签中的内容为 checkbox 按钮后的介绍。
CheckBox基本用法
CheckBoxGroup基本用法
CheckBox参数
参数 | 类型 | 默认 | 说明 |
---|---|---|---|
v-model | boolean | -- | 必选,选中项绑定值 |
disabled | boolean | false | 可选,是否禁用 |
label | LabelType | -- | 单独使用 check-box 且无默认插槽时当作info展示,存在插槽帮定制无效,结合 check-box-group使用时作为选中项的值。 |
color | string | -- | 可选,复选框颜色 |
beforeChange | BeforeChangeType | -- | 可选,checkbox 切换前的回调函数,返回 boolean 类型,返回 false 可以阻止 checkbox 切换 |
CheckBox事件
事件 | 类型 | 说明 |
---|---|---|
change | Function | 复选框的值改变时发出的事件,值是当前状态 |
CheckBox类型定义
LabelType
ts
export type LabelType = string | number | boolean
BeforeChangeType
ts
export type BeforeChangeType = (
isChecked: boolean,
v: string
) => boolean | Promise<boolean>
CheckBox插槽
默认插槽
CheckBoxGroup参数
参数 | 类型 | 默认 | 说明 |
---|---|---|---|
v-model | Array | [] | 必选,选中项绑定值 |
disabled | boolean | false | 可选,是否禁用 |
color | string | -- | 可选,复选框颜色 |
direction | DirectionType | 'column' | 可选,设置横向或纵向排列 |
beforeChange | BeforeChangeType | -- | 可选,checkbox 切换前的回调函数,返回 boolean 类型,返回 false 可以阻止 checkbox 切换 |
CheckBoxGroup类型定义
DirectionType
ts
export type DirectionType = 'row' | 'column'
CheckBoxGroup事件
事件 | 类型 | 说明 |
---|---|---|
change | Function | 复选框的值改变时发出的事件,值是当前状态 |
CheckBoxGroup插槽
默认插槽