YCheckbox

适用范围：Legacy Admin Kit / Schema 与旧 admin-vue。新 admin-nuxtui 的开发入口见管理端 Nuxt UI 指南。

定位 / Owner

YCheckbox 是 Admin Kit 的受控布尔选择 facade，拥有 checked、indeterminate、disabled 与标签组合，不拥有表单提交状态。

什么时候使用

用于独立确认项、多选集合和树节点选择；文字标签可用 label 或 default slot 提供。

不什么时候使用

即时生效的单一设置优先使用 YSwitch；单选集合使用 YSelect 或 radio composition。

Public API

v-model<boolean>；props：disabled、indeterminate、label；default slot 提供自定义标签内容。

Composition

在字段布局中由 YFormField 或业务 <label> 提供上下文；权限树内部由 YTree 统一组织。

Anti-pattern

不要读取 primitive DOM/class，也不要同时用 indeterminate 表达业务第三态并把它写回 boolean model。

Production Example

Sign-in “记住我”、Edition/Role 编辑器、Tenant Editor 和 Data Workbench selection 都直接消费它。

Live Workbench

/frontend-module-demo/component-workbench/checkbox

Verification / Source

• packages/yoyo-admin/admin-kit/src/ui/components/checkbox/YCheckbox.vue
• Admin Kit facade/runtime fixture tests 与真实表单 consumer