SuperAPI AI 工具集

tooltips

通用与其它

查看项目

更新于 10-16 00:29

技能介绍

用途:在实现或审查 tooltip 组件时应用无障碍规则,仅在项目确实包含 tooltip 时加载。核心要求是 tooltip 为简短、非交互的描述,在触发器获得键盘焦点或指针悬停时自动出现,且不隐藏关键信息、不阻塞界面。

主要能力:提供模式选择表(何时用可见标签、持久帮助文本、按钮控制的披露、非模态/模态对话框、状态消息,而非 tooltip);给出严重度分级(Critical:关键信息仅存在于 tooltip;Serious:键盘或辅助技术无法触发、交互内容被困在 tooltip 内;Moderate:未完全满足 WCAG 1.4.13;Minor:最佳实践差距)。

必要用法:tooltip 元素需 role="tooltip" 且唯一 id,触发器用 aria-describedby 引用(保留已有引用),用 hidden 隐藏而非 aria-hidden;触发器用原生交互元素,图标按钮需独立可访问名称;tooltip 不可聚焦、不含交互内容、不加 aria-live/role=status/alert,自动显示的 tooltip 不用 aria-expanded/aria-haspopup。需同时支持悬停与焦点,Escape 可关闭且焦点不移动,指针可移入 tooltip 而不消失,不设固定超时自动关闭。

适用场景:短补充说明、图标按钮描述等。限制:触屏无可靠悬停,不应依赖 tooltip;title 属性行为由浏览器控制,不可作为唯一标签、说明或截断文本的访问途径;内容长或结构化、含链接按钮时应改用披露、popover 或对话框。测试需覆盖键盘、指针、触屏、放大与屏幕阅读器,自动化无法验证悬停性、持久性与读屏呈现。