SuperAPI AI 工具集

color-contrast

通用与其它

查看项目

更新于 10-16 03:35

技能介绍

用途:该技能针对前端页面中所有可见文本、文本图像、UI 组件边框(输入框、按钮)、焦点指示器和有含义的图标,检查颜色对比度是否达到 WCAG 最低要求。低对比度是最常见的 WCAG 失败项之一,会影响低视力用户、老年用户、色觉障碍用户以及在强光下阅读的用户。

主要能力与标准:正常文本(小于 18pt,或小于 14pt 粗体)最低对比度为 4.5:1,对应 WCAG 2.1 SC 1.4.3 Level AA;大文本(大于等于 18pt / 24px,或大于等于 14pt 粗体 / 约 18.67px 粗体)最低为 3:1。非文本 UI 组件(图标、焦点指示器、输入框边框)相对相邻颜色最低为 3:1,对应 WCAG 2.1 SC 1.4.11 Level AA。WCAG 2.1 SC 1.4.6(Level AAA)要求正常文本 7:1、大文本 4.5:1。装饰性文本和标识语可豁免。

使用方式:评估页面所有文本前景色与背景色之间的对比度,使用 WCAG 相对亮度公式;计算方式为 (L1 + 0.05) / (L2 + 0.05),L1 为较亮色、L2 为较暗色,1:1 表示无对比,21:1 为最大值。还需检查所有交互状态:默认、hover、focus、active 和 visited。可使用对比度检查工具(WebAIM、浏览器 DevTools 无障碍面板)验证具体比值。修复时加深前景色或调亮/调暗背景色直到达标;不要用 opacity 调亮文本,而应计算混合后的有效颜色再检查比值。代码审查环节应针对渲染后的标记和交互状态,指出违反规则的元素、角色、标签、焦点行为或键盘交互,并说明如何用浏览器无障碍工具或辅助技术验证修复。

适用场景:前端可访问性审查、设计稿校验、组件库合规检查。限制:装饰性文本与标识语豁免;完整实现细节、代码示例和框架专属指引见 references/rule.md。