Checkbox 复选框

原生 <input type="checkbox"> 增强，支持半选与多选组。

基础用法

基础用法

已勾选未勾选

示例代码

半选状态

半选（indeterminate）

半选状态

示例代码

配合全选联动场景（见下方示例）使用，用于表达「部分选中」。

禁用

禁用

已选且禁用未选且禁用

示例代码

多选组

多选组（checkbox-group）

水果（可选多个）苹果香蕉橙子

示例代码

组通过 value（JSON 数组）受控，子项 value 作为选项标识。

全选 / 半选联动

全选与半选联动

全选苹果香蕉橙子

示例代码

事件

选择事件

苹果香蕉橙子

示例代码

监听 oas-change：单项派发 detail: { checked, value }，组派发 detail: { value: string[] }。

API

属性

属性	说明	类型	默认值
checked	是否选中	boolean	—
disabled	禁用	boolean	—
indeterminate	半选状态	boolean	—
value	选项标识	string	—

事件

事件	说明
oas-change	变化，detail: { checked, value }；组为 detail: { value }（数组）

插槽

名称	说明
默认	—

oas-checkbox-group：value（JSON 数组）、disabled，支持 slot="label" 设置组标题。