UI 视觉设计 / 系统课时
定义提示气泡与弹出层触发
定义提示气泡与弹出层触发
同一个帮助图标旁,简短说明适合 Tooltip,包含选项、链接或操作按钮则应使用 Popover。本节给出两者在鼠标、键盘和触屏下的开启、保持与关闭规则,并通过具体场景解决失焦即关闭、内容不可点击及触屏无法触发等常见问题。
学习目标
- 根据内容和交互需求选择 Tooltip 或 Popover。
- 制定悬停、点击、焦点移动与 Escape 的触发和关闭规则。
- 验证键盘、鼠标和触屏下的可用性与一致性。
根据内容是否需要交互选择组件
以订单列表中的“计费说明”为例:仅解释“金额不含运费”时,使用 Tooltip;需要切换“含税 / 未税”并确认时,使用 Popover。判断依据是用户是否需要把焦点移入浮层执行操作,而不是浮层尺寸。
| 判断项 | Tooltip | Popover |
|---|---|---|
| 内容 | 简短补充说明 | 表单、筛选、链接或操作按钮 |
| 默认触发 | 鼠标悬停、键盘聚焦 | 点击、键盘激活、触屏轻点 |
| 焦点 | 保留在触发器 | 可以进入面板内部控件 |
| 典型场景 | 解释统计口径 | 筛选状态并应用 |
| 关闭方式 | 移出、失焦、Escape | 外部点击、Escape、约定的失焦行为 |
Tooltip 不应包含可交互控件。若一段提示里出现“了解更多”链接、复选框或确认按钮,就需要重新判断是否采用 Popover。
Tooltip 的悬停与聚焦规则
Tooltip 适合补充说明,例如在“退款金额”旁显示“统计口径:近 7 天已完成退款的订单”。建议采用以下参数作为组件库默认值,具体时长可以通过实际用户测试调整。
| 参数 | 建议值 | 行为 |
|---|---|---|
| 鼠标首次显示延迟 | 400 ms | 避免指针经过时频繁弹出 |
| 鼠标移出关闭延迟 | 150 ms | 容忍触发器与气泡之间的短暂移动 |
| 键盘聚焦显示延迟 | 0 ms | 焦点到达后立即展示 |
| Escape | 立即关闭 | 无须移开鼠标或焦点 |
触发与关闭遵循以下规则:
- 指针进入触发器后开始计时,连续悬停达到 400 ms 才显示 Tooltip。
- 指针从触发器移动到气泡时保持显示,不能因为经过两者之间的间隙就立即关闭。
- 指针离开触发器和气泡的整体区域后,等待 150 ms 再关闭。若在这段时间内重新进入,则取消关闭。
- 键盘焦点进入触发器时立即显示;焦点离开时关闭。气泡自身不参与 Tab 导航。
- Escape 立即关闭,并避免在同一次持续悬停或聚焦期间自动重新打开;新的悬停或聚焦周期可以再次触发。
不要设置“显示 3 秒后强制消失”的固定时限。只要悬停或聚焦条件仍然成立,用户就应有足够时间阅读说明。这符合 WCAG 1.4.13 对可关闭、可悬停和持续显示的要求。
Popover 的点击、保持与失焦关闭
例如点击“筛选状态”按钮后,打开包含三个复选项和“应用”按钮的 Popover。它是非模态局部操作区,用户仍可以操作页面其他区域,而不需要像模态确认对话框一样锁定背景。
- 鼠标点击、键盘 Enter / Space 或触屏轻点触发器时打开;再次激活同一触发器时关闭。
- 打开后,Tab 可以按合理顺序进入内部的复选框和“应用”按钮。焦点从触发器进入面板不应造成关闭。
- 在面板内部点击、移动指针或切换内部焦点时,Popover 必须保持打开。
- 按 Escape 关闭面板,并将焦点恢复到仍然存在的触发器。
- 点击触发器和面板以外的区域时关闭,但不能阻止外部目标本身获得焦点或执行点击操作。
- 如果组件规范要求失焦关闭,应在焦点离开“触发器 + 面板”的整体交互区域时才关闭,而非触发器单独失焦时关闭。
- 点击“应用”后先完成筛选条件提交,再关闭面板;若操作失败且需要用户修正,应保留面板并展示错误。

这里最容易出错的是将触发器的 blur 事件直接作为关闭条件。用户按 Tab 准备进入面板里的复选框时,触发器必然先失去焦点;如果立即关闭面板,内部操作就永远无法通过键盘完成。
对于使用 Portal 渲染到页面其他节点的浮层,还应把触发器与浮层都纳入焦点边界判断,不能仅依靠触发器父元素是否包含当前焦点。
触屏替代与无障碍语义
触屏没有可靠的 hover 交互,不应依赖长按打开 Tooltip。若说明必须在移动端可访问,优先直接展示简短文字;空间不足时,提供可点击的“说明”按钮,轻点打开包含相同信息的 Popover。
建议帮助图标的触控目标至少达到 44 × 44 CSS px,作为团队的易触达性目标。对于不能直接关闭的内容,明确提供关闭按钮,并允许轻点外部区域退出。
无障碍语义按实际内容选择:
- Tooltip:使用
role="tooltip"标记说明容器,并通过触发器的aria-describedby关联说明内容;焦点始终保留在触发器上。 - Popover:触发器可以使用
aria-expanded暴露展开状态,并通过aria-controls关联面板。包含普通表单控件的非模态面板可以采用有可访问名称的对话框语义。 - 特殊面板:如果本质上是菜单或列表框,应采用对应的语义和键盘规则,而不是将所有 Popover 都声明为对话框。
Web 原生 popover="auto" 支持外部点击和 Escape 等轻量关闭行为,但 popover 属性本身不会自动把任意内容变成有正确对话框语义的组件。设计规范应将外观、触发、焦点和语义分别写清。
按输入设备验收交互规则
使用同一组 Tooltip 和筛选 Popover,分别在鼠标、仅键盘以及手机触屏环境中完成以下检查。
| 操作 | 预期行为 |
|---|---|
| 鼠标悬停不足400 ms | Tooltip暂不显示 |
| 鼠标持续悬停并移入气泡 | Tooltip显示且不闪退 |
| Tooltip显示后按Escape | 立即关闭且不会原地反复弹出 |
| Tab聚焦帮助图标 | 能获得说明,焦点仍在图标 |
| 打开Popover后连续按Tab | 能进入并操作三个复选框与应用按钮 |
| Popover内部交互 | 不因触发器失焦而关闭 |
| Popover打开后按Escape | 关闭并恢复触发器焦点 |
| 点击Popover外部输入框 | 浮层关闭,输入框正常获得焦点 |
| 手机轻点说明或筛选按钮 | 可以打开、操作和关闭对应内容 |
评审中出现“鼠标能看见、键盘看不见”“指针移动到气泡就消失”或“点击外部后焦点跳回原处”,应分别检查触发事件、悬停区域和关闭后的焦点恢复策略。Tooltip 与 Popover 只有在这些输入路径下都能完成相同的信息获取或操作任务,行为规范才算通过验收。