Checkbox 复选框

用于在一组可选项中进行多选，也可单独作为开关使用。支持分组、全选、半选、异步前置校验、尺寸和类型等能力。

基础用法

通过 v-model 绑定布尔值，表示选中与否。

同意协议

当前：false

• 复制代码
• 显示代码

复选框组

使用 ue-checkbox-group 管理一组选项，v-model 绑定数组。

苹果香蕉橙子

选中：banana

• 复制代码
• 显示代码

全选

使用 ue-checkbox-all 组件实现全选/半选逻辑，内部复选框与外部 v-model 同步。

全选

选项 A选项 B选项 C

当前全选值：A

• 复制代码
• 显示代码

半选（Indeterminate）

设置 indeterminate 展示半选视觉，一般配合全选或分组使用。

全选

苹果香蕉橙子

选中：苹果

• 复制代码
• 显示代码

类型与尺寸

通过 type 展示主题风格，通过 size 设置尺寸（sm/md/lg/xl）。

默认PrimarySuccessWarningError

• 复制代码
• 显示代码

禁用

设置 disabled 使其不可选，支持已选/未选两种状态。

禁用（未选）禁用（已选）

• 复制代码
• 显示代码

异步前置校验

通过 beforeChange 返回 Promise，可在切换前进行校验/提交，期间展示加载中。

异步切换（1.2s 后生效）

当前：false

• 复制代码
• 显示代码

属性

组件	属性名	类型	默认值	说明
ue-checkbox	v-model	boolean	false	单个复选框的选中状态
ue-checkbox	value	string/number/boolean	-	作为分组时的选项值，用于比对是否选中
ue-checkbox	disabled	boolean	false	是否禁用
ue-checkbox	size	string	sm	尺寸：sm/md/lg/xl
ue-checkbox	type	string	''	风格类型：primary/success/warning/error 等
ue-checkbox	beforeChange	() => Promise	-	切换前置校验，resolve 后才会切换并结束加载
ue-checkbox	indeterminate	boolean	false	半选视觉状态（仅样式，不改变值）
ue-checkbox-group	v-model	Array	[]	选中项数组
ue-checkbox-group	size	string	sm	组内项的统一尺寸
ue-checkbox-group	beforeChange	() => Promise	-	组级前置校验，优先级高于子项的 beforeChange
ue-checkbox-all	v-model	Array	[]	与内部组的选中项同步
ue-checkbox-all	size	string	sm	全选及子项尺寸

事件

组件	事件名	回调参数	触发说明
ue-checkbox	change	(checked: boolean, evt)	原生 change 触发，返回是否选中及原事件
ue-checkbox-group	change	(value: any[])	组选中值变化时触发
ue-checkbox-all	change	(value: any[])	全选包装器内部组选中值变化时触发

## 插槽

插槽名	说明
default	文本或自定义内容，位于复选框右侧