YTree

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

定位 / Owner

YTree 是层级多选 facade，父级 model 保持 authoritative，组件负责 delayed/stale echo draft、搜索、selected-only、批量选择与展开浏览。

什么时候使用

用于 Role/User Permission 等需要父子结构和批量操作的选择任务。

不什么时候使用

扁平少量选项使用 Checkbox group；远程树、懒加载或业务权限决策需要独立 owner。

Public API

v-model<string[]>；props：nodes、disabled、emptyText、searchable、showToolbar、showToolbarClear、confirmClear、searchPlaceholder；emit：clear-request。

Composition

节点结构来自 feature adapter；YTree 只拥有交互 draft，不复制权限数据或保存状态。

Anti-pattern

不要从可见过滤结果重建全部 selection；不要为 confirm-clear 在组件内部创建第二确认系统。

Production Example

RolePermissionEditor 与 UserPermissionOverlay 直接消费它。

Live Workbench

/frontend-module-demo/component-workbench/tree

Verification / Source

• packages/yoyo-admin/admin-kit/src/ui/components/tree/YTree.vue
• ytree-controlled-selection.spec.ts 与权限 consumer intent tests