Checkbox
Checkbox 属于 表单 分类。建议先看演示与用法，再对照 API 表格完成接入和样式调整。
先用快捷跳转面板找到概述、用法、演示和 API，再往下细读完整文档内容。
如果你在同一类交互里做组合，这些组件通常会一起出现。
版本记录按发布版本分组，便于快速查看这个组件在不同版本里的实际变更。
2026-05-11
2026-04-26
2026-03-01
根据槽或标签的存在有条件地渲染 CheckboxLabel；更新根变体样式
2026-01-21
修复标记符格式
2026-01-19
支持键盘输入以切换选中状态
2025-11-18
新增支持多种状态和分组功能的复选框组件
重构复选框组件，以利用新的主题上下文，并通过 SCheckbox 和 SCheckboxGroup 改进结构
新增 CheckboxCard 和 CheckboxCardGroup 组件，通过卡片式布局增强复选框功能，并优化了 UI 集成
添加颜色和尺寸示例，增强复选框卡片和组组件的颜色支持，并改进复选框标签
引入形状和图标示例，为复选框组件增强形状支持，并更新卡片组的样式
更新点击处理程序，在访问 modelValue 之前先检查 groupContext 是否存在
从共享复选框文件中移除未使用的常量和 CSS 变量
整合 CheckedState 的类型定义，并更新相关函数以提高清晰度
简化复选框组件的结构，并通过改进状态管理来增强分组功能
通过引入 getAriaLabel 函数并更新元素引用，增强无障碍功能和状态管理
通过确保 modelValue 仅使用非空值进行更新，从而提高类型安全性
更新复选框的上下文和样式，改用 data-state 属性以改进状态管理
将 `isIndeterminate` 函数移至共享工具类，并清理导入语句
新增支持多种状态和分组功能的复选框组件
重构复选框组件，以利用新的主题上下文，并通过 SCheckbox 和 SCheckboxGroup 改进结构
新增 CheckboxCard 和 CheckboxCardGroup 组件，通过卡片式布局增强复选框功能，并优化了 UI 集成
添加颜色和尺寸示例，增强复选框卡片和组组件的颜色支持，并改进复选框标签
引入形状和图标示例，为复选框组件增强形状支持，并更新卡片组的样式
更新点击处理程序，在访问 modelValue 之前先检查 groupContext 是否存在
从共享复选框文件中移除未使用的常量和 CSS 变量
整合 CheckedState 的类型定义，并更新相关函数以提高清晰度
简化复选框组件的结构，并通过改进状态管理来增强分组功能
通过引入 getAriaLabel 函数并更新元素引用，增强无障碍功能和状态管理
通过确保 modelValue 仅使用非空值进行更新，从而提高类型安全性
更新复选框的上下文和样式，改用 data-state 属性以改进状态管理
将 `isIndeterminate` 函数移至共享工具类，并清理导入语句