文字提示
Tooltip
UI 组件也叫:工具提示、悬停提示、提示气泡、Hint
一句话:鼠标悬停或键盘聚焦在某个元素上时,在旁边弹出的一小段深色说明文字,移开即消失。
详细解释
文字提示是一个很小的浮层,用户把鼠标移到某个元素上或用键盘聚焦时出现,通常是深色底白字,带一个指向目标的小箭头,鼠标移开就消失。它最常用来解释只有图标、没有文字的按钮,比如在铅笔图标上提示「编辑」,或者显示被截断文字的完整内容。
它只放一两句简短的纯文字,不能放按钮、链接、图片这类可交互内容,因为鼠标一移开它就没了,用户点不到。需要放更多内容或操作时,应该用气泡卡片,它由点击触发,内容可以更丰富。
手机上没有悬停,文字提示在触屏上基本看不到,所以关键信息不能只藏在文字提示里。
示例
灰度线框示意,只表达结构,不代表具体视觉风格。
怎么跟 AI 说
可以直接贴给 Cursor、Claude Code 等工具,把里面的业务内容换成你自己的。
给工具栏里只有图标的按钮加文字提示:悬停 300 毫秒后在按钮上方显示深灰底白字说明,如「编辑」「删除」「导出」,字号 12px、带指向按钮的小箭头;键盘聚焦时同样显示,鼠标移开或按 Esc 时消失。靠近屏幕边缘时自动换到另一侧显示。
结构与适用场景
结构描述
由触发元素和悬停时出现的小浮层组成,浮层内是一两句纯文字,并带一个指向触发元素的小箭头。
适用场景
- 只有图标没有文字的按钮,需要告诉用户它是做什么的
- 文字因空间不够被截断成省略号,需要悬停查看完整内容时
- 表单字段或数据指标旁的问号图标,需要一句简短补充解释时
不适用场景
- 需要放按钮、链接或表单等可交互内容时,应该用气泡卡片
- 告知操作完成后的结果时,应该用轻提示
- 用户必须看到的关键信息,手机上无法悬停,不能只放在文字提示里
常见坏用法
- 在文字提示里放「查看详情」链接或按钮,鼠标一移过去提示就消失了,根本点不到
- 给本来就写着清楚文字的按钮,再加一个内容完全相同的文字提示
- 在提示里塞几段长文字,浮层变成一大块,遮住下面的内容
识别特征
- 某个图标或文字上方或旁边的一小块深色浮层
- 浮层里是一行白色小字,带一个指向目标的三角箭头
- 只在鼠标悬停时出现,截图里常伴随鼠标指针
DOM 线索
插件本地识别时匹配的 CSS 选择器(标签、ARIA role、常见组件库 class)。
[role="tooltip"].tooltip.ant-tooltip.el-popper.is-dark[class*="MuiTooltip-tooltip"].arco-tooltip.t-tooltip[data-slot="tooltip-content"]