跳转正文

YTooltip ​

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

定位 / Owner ​

YTooltip 为可聚焦 trigger 补充简短说明,统一 hover/focus overlay 与 nested portal 行为。

什么时候使用 ​

用于 icon-only action 或被折叠菜单项的辅助说明。

不什么时候使用 ​

关键业务信息、错误或必须阅读的说明不得只存在 Tooltip;使用可见文本或 YAlert。

Public API ​

props:content、placement(top/right/bottom/left);default slot 必须提供可聚焦 trigger。

Composition ​

trigger 仍由 YButton 等 production control 拥有,Tooltip 不接管其 click/state。

Anti-pattern ​

不要包裹不可聚焦的空 span,也不要把交互控件放进 Tooltip content。

Production Example ​

App Sidebar 在收起状态下用它显示菜单名称。

Live Workbench ​

/frontend-module-demo/component-workbench/tooltip

Verification / Source ​

  • packages/yoyo-admin/admin-kit/src/ui/components/tooltip/YTooltip.vue
  • SidebarMenuTree consumer 与 Admin Kit accessibility tests

YoyoBoot · 从真实项目走向可复用能力