---
url: /components/checkbox.md
---
# Checkbox 多选框

可多选的勾选控件：在 `eb-checkbox-group` 中放置若干 `eb-checkbox`（或按钮风格的 `eb-checkbox-button`），绑定值为选中 label 组成的数组；独立使用时支持 boolean / 数组 / true-label 等值语义。在 eb-form 中 change 时机自动触发校验。

## 基础用法

绑定值为选中 label 组成的数组；单个 checkbox 设置 disabled 只禁用自身（如上例 Svelte），适合个别选项不可勾选的场景。

## 整组禁用

group 设置 disabled 后整组不可勾选，常用于权限不足、前置条件未满足时的回显展示。

## 边框与尺寸

border 呈卡片描边样式；size 控制尺寸（large / small），组内可由 group 的 size 统一设置。

## 按钮风格

eb-checkbox-button 为连体按钮组风格，适合筛选项较多的紧凑布局。

## 数量限制

group 的 `max / min` 限制可勾选数量：达到上限后未选项自动禁用，达到下限后已选项禁止取消，用于限选场景（如最多选 2 个标签）。

## 全选联动

经典全选组合：全选框用 indeterminate 表达半选态（部分选中），change 时全量写入 / 清空数组；子项 change 里根据选中数量同步全选态。indeterminate 只影响样式，不写入绑定值。

handleCheckAll / handleCityChange 定义见页面顶部 script：全选时写入 `[...cities]`，取消时清空数组，子项变化后按数量回写 checkAll。

## API