Checkbox 复选框

属性名	说明	类型	默认值
modelValue / v-model	绑定的选中状态。启用时通过点击、Enter 或 Space 更新。	`boolean`	`false`
disabled	是否禁用。禁用后不可聚焦，且不会触发切换。	`boolean`	`false`
loading	异步提交中：方框变为旋转环，添加 `is-loading` 与 `aria-busy="true"`，并像 `disabled` 一样阻止切换，但不套用禁用态配色。	`boolean`	`false`
label	显示在复选框旁边的文本标签。	`string`	-
labelPlacement	标签位置：`start` 为前置，`end` 为后置。	`'start' \| 'end'`	`'end'`
variant	视觉变体：`fill` 为纯填充，`checkmark` 为内部勾选标记。	`'checkmark' \| 'fill'`	`'checkmark'`
ariaLabel	无可见 `label` / 默认插槽时使用的可访问性标签。	`string`	-
indeterminate	部分选中：所辖项目选中了一部分但不是全部。渲染横杠并上报 `aria-checked="mixed"`；此时点击会解析为「全选」而不是翻转布尔值，与原生 `indeterminate` 行为一致。	`boolean`	`false`

事件名	说明	回调参数
update:modelValue	用户切换后触发的 v-model 更新事件。	`(value: boolean) => void`
change	用户切换后触发的状态变更事件。	`(value: boolean) => void`

插槽名	说明
default	自定义可见标签内容；存在时会替代 `label` 展示。

最佳实践

已核对 packages/tuffex/packages/components/src/checkbox/src/TxCheckbox.vue 与 checkbox.test.ts。
加载契约: loading 是纯视觉与阻断状态，组件不持有异步逻辑。环的颜色仍由 modelValue / indeterminate 决定，因此它停在旧值上，表示这一次切换尚未落地。
加载态的已知取舍: 已选中与部分选中在加载期间外观一致（同为主色环），这一差异由 aria-checked="mixed" 承担。曾试过「保留填充 + 白色环」以区分两者，但白环压在浅色页面上几乎不可见，因此改为环着色方案。
可访问性说明:根节点负责 role="checkbox"、aria-checked 与键盘处理;应优先提供可见标签或默认插槽,仅在没有可见文案时使用 ariaLabel。
动效降级: 环形指示器在 prefers-reduced-motion: reduce 下停止旋转；缺口边框本身是静态字形，提示不会消失。
实测覆盖: checkbox.test.ts 覆盖标签渲染、aria-label 回退、标签位置、默认 checkmark 变体与显式 fill / checkmark 变体、点击事件、禁用阻断，以及加载中阻断、is-loading 与 is-disabled 分离、部分选中在加载时仍上报 mixed、aria-busy 的出现与消失。

Component source: packages/tuffex/packages/components/src/checkbox/src/TxCheckbox.vue。
Export alias: packages/tuffex/packages/components/src/checkbox/index.ts 同时导出 TuffCheckbox 与 TxCheckbox。
Coverage: packages/tuffex/packages/components/src/checkbox/__tests__/checkbox.test.ts 覆盖点击切换、ARIA 标签、插槽优先级、变体 class 与禁用阻断；键盘激活由原生 <button> 元素继承。

packages/tuffex/packages/components/src/checkbox/index.ts