文字气泡提示（Tooltip）· 码译

图标或缩写不知道啥意思，hover 也没说明，只能猜

文字气泡提示

Tooltip

反模式图标/缩写无说明，用户不敢点，靠猜

正解悬停/长按图标给出气泡说明，移开即消失

在线对比体验 · 同一个需求，大白话 vs 平台提示词，效果立分高下 · 右边可点击体验

大白话直接生成

工具栏

ⓘ ? ★

啥意思？只能猜

平台提示词生成

工具栏

ⓘ

查看使用说明

点一下试试

差在哪？大白话没讲「图标/缩写无说明，用户不敢点，靠猜」，AI 只能自己猜；平台提示词写明「悬停/长按图标给出气泡说明，移开即消失」，还带要点与三端注意，一次到位不用返工。

代码示例

错误写法

<button>ⓘ</button> /* 不知啥意思 */

正确写法

<button aria-label='帮助' title='查看使用说明'>ⓘ</button>

语义锚点 · 对齐 AI 语义库契约

<div data-vibe="tooltip"> … 组件根元素 … </div><!-- AI 用语义名片 locate 此属性即可定位/修改 -->

在组件根元素挂 data-vibe="tooltip"，AI 用语义名片里的 locate（[data-vibe='tooltip']）即可定位、修改、组合该组件——与「AI 语义库」tab 的契约一一对应。在 AI 语义库看契约 →

不同平台注意

网页title 属性最简单，复杂用自绘气泡

AppTooltip 组件 onPress 长按触发

小程序长按弹出气泡

可直接复制的提示词（三端都给你，挑对应平台复制给 Cursor / 通义灵码 / Claude）

网页 Web

你是一位资深前端工程师。我想实现【文字气泡提示】（专业术语：Tooltip）。

【我想达到的效果】图标或缩写不知道啥意思，hover 也没说明，只能猜。
【请避免的反模式】图标/缩写无说明，用户不敢点，靠猜。
【正确做法】悬停/长按图标给出气泡说明，移开即消失。

【平台】网页 Web（标准 HTML/CSS/JS，单文件零依赖，不引任何 CDN）。
【提示词要点】
- Tooltip 是解释而非替代标签
- 移动端用长按/点击触发（无 hover）
- 气泡别挡住操作元素
- 内容要短，一句说清

请输出完整可运行代码（关键处写中文注释），并附 50 字以内使用说明。

手机 App

你是一位资深前端工程师。我想实现【文字气泡提示】（专业术语：Tooltip）。

【我想达到的效果】图标或缩写不知道啥意思，hover 也没说明，只能猜。
【请避免的反模式】图标/缩写无说明，用户不敢点，靠猜。
【正确做法】悬停/长按图标给出气泡说明，移开即消失。

【平台】手机 App（React Native / Flutter / 原生，给出对应组件与关键代码）。
【提示词要点】
- Tooltip 是解释而非替代标签
- 移动端用长按/点击触发（无 hover）
- 气泡别挡住操作元素
- 内容要短，一句说清

请输出完整可运行代码（关键处写中文注释），并附 50 字以内使用说明。

微信小程序

你是一位资深前端工程师。我想实现【文字气泡提示】（专业术语：Tooltip）。

【我想达到的效果】图标或缩写不知道啥意思，hover 也没说明，只能猜。
【请避免的反模式】图标/缩写无说明，用户不敢点，靠猜。
【正确做法】悬停/长按图标给出气泡说明，移开即消失。

【平台】微信小程序（WXML/WXSS/JS，注意 rpx 单位与小程序专属约束）。
【提示词要点】
- Tooltip 是解释而非替代标签
- 移动端用长按/点击触发（无 hover）
- 气泡别挡住操作元素
- 内容要短，一句说清

请输出完整可运行代码（关键处写中文注释），并附 50 字以内使用说明。