气泡提示 · Tooltip
英文：Tooltip
常用组件难度：入门 ★
🗣️一句话大白话
鼠标悬停或键盘聚焦到图标时，旁边出现一小块简短说明。它只适合补充短信息。
🖼️样图参考
🎬真实场景
图标解释、术语补充、按钮名称、图表数据说明
📮你可以这样说
「在 Punk 的项目卡片图标上添加 Tooltip，鼠标 hover 或键盘 focus 时显示， 内容控制在一句话以内，Tooltip 不获得独立焦点，离开触发元素或按 Esc 后消失； 不要只支持 hover，触屏设备需要提供可理解的替代方式。」
通过 AI绘图 工作台生成（模型 API 额度由此消耗）；未配置模型密钥时会提示失败原因。
⚠️边界与常见误解
- ▸误解：Tooltip 能放很多文字。实际只适合一句话补充，长说明应放正文或弹层
🚫什么时候别用
- ✗触屏为主、无法 hover 的场景（需替代方案）
- ✗内容较长时
🧩常见变体
图标 Tooltip按钮 Tooltip
🕸️知识关系图
这个词条与相关术语、AI绘图 知识的连接关系