跳到主要内容
前端术语库

文字提示

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"]