YDropdown

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

定位 / Owner

YDropdown 是动作菜单 facade，拥有键盘菜单语义、nested overlay portal、选择后的 trigger focus restore 与 danger item 语义。

什么时候使用

用于 Shell、Tabs 或详情工具栏中不能同时展示的次级动作。

不什么时候使用

主动作应直接可见；选择一个字段值应使用 YSelect，不要用 action menu 模拟 select。

Public API

props：items、label、iconOnly、contentSize；emit：select(id)；trigger slot 暴露 open。

Composition

items 由业务 owner 计算；Dropdown 只负责菜单交互和把稳定 id 交还宿主。

Anti-pattern

不要把 Router、Dialog 或 mutation 状态塞入 item；不要依赖 portal DOM/class。

Production Example

AppHeader、PageTabs、Feature Tree 与 Drawer 内 action menu 直接消费它。

Live Workbench

/frontend-module-demo/component-workbench/dropdown

Verification / Source

• packages/yoyo-admin/admin-kit/src/ui/components/dropdown/YDropdown.vue
• Admin Kit keyboard/focus/nested-overlay tests