Skip to content

CheckBox 多选框

一组备选项中进行多选

何时使用

在一组选项中进行多项选择;

单独使用可以表示两种状态之间的切换,写在标签中的内容为 checkbox 按钮后的介绍。

CheckBox基本用法

CheckBoxGroup基本用法

CheckBox参数

参数类型默认说明
v-modelboolean--必选,选中项绑定值
disabledbooleanfalse可选,是否禁用
labelLabelType--单独使用 check-box 且无默认插槽时当作info展示,存在插槽帮定制无效,结合 check-box-group使用时作为选中项的值。
colorstring--可选,复选框颜色
beforeChangeBeforeChangeType--可选,checkbox 切换前的回调函数,返回 boolean 类型,返回 false 可以阻止 checkbox 切换

CheckBox事件

事件类型说明
changeFunction复选框的值改变时发出的事件,值是当前状态

CheckBox类型定义

LabelType

ts
export type LabelType = string | number | boolean

BeforeChangeType

ts
export type BeforeChangeType = (
  isChecked: boolean,
  v: string
) => boolean | Promise<boolean>

CheckBox插槽

默认插槽

CheckBoxGroup参数

参数类型默认说明
v-modelArray[]必选,选中项绑定值
disabledbooleanfalse可选,是否禁用
colorstring--可选,复选框颜色
directionDirectionType'column'可选,设置横向或纵向排列
beforeChangeBeforeChangeType--可选,checkbox 切换前的回调函数,返回 boolean 类型,返回 false 可以阻止 checkbox 切换

CheckBoxGroup类型定义

DirectionType

ts
export type DirectionType = 'row' | 'column'

CheckBoxGroup事件

事件类型说明
changeFunction复选框的值改变时发出的事件,值是当前状态

CheckBoxGroup插槽

默认插槽

Released under the MIT License.