颜色对比度检测器

检测任意前景与背景色的 WCAG 对比度。按正文、大号文字、UI 组件分别给出 AA/AAA 通过状态;不达标时一键给出「保留色相、调整亮度」的修正建议。

  • 在浏览器中处理
  • 工具不会把输入上传到 ZeroTool 服务器
  • 免费 · 无需注册
永和九年岁在癸丑 The quick brown fox 0123456789 永和九年岁在癸丑 The quick brown fox 0123456789
对比度 显示值截断至两位小数。正文 AA/AAA 门槛为 4.5/7;大号文字为 3/4.5;UI 组件 AA 为 3,未设 AAA 门槛。
—
正文
< 24px 或 < 18.66px 粗体
AA
AAA
大号文字
≥ 18.66px 粗体或 ≥ 24px
AA
AAA
UI 组件 & 图形
边框、图标、聚焦环(WCAG 1.4.11)
AA
AAA —
阅读完整使用指南 颜色对比度检测器:在不杀死品牌色的前提下通过 WCAG AA
示例、说明与常见问题 带实际输出的示例、与同类工具的差别,以及常见问题。

WCAG 对比度公式

WCAG 2.x 对比度基于两种颜色的相对亮度计算。每个 sRGB 通道经分段 gamma 解码后,按 0.2126·R + 0.7152·G + 0.0722·B 加权得到亮度,对比度公式为 (L1 + 0.05) / (L2 + 0.05),其中 L1 为较亮一方。结果取值范围 1(无对比)到 21(纯黑配纯白)。

三档场景:正文 / 大号 / UI

WCAG 2 按使用场景分档:

  • 正文(成功标准 1.4.3)——AA ≥ 4.5 : 1,AAA ≥ 7 : 1。涵盖小于 24 px 常规字号或小于 18.66 px 粗体的文字。
  • 大号文字——AA ≥ 3 : 1,AAA ≥ 4.5 : 1。涵盖 18.66 px 粗体及以上或 24 px 常规及以上的文字。WCAG 原文写的是 18 点或 14 点粗体,并注明中日韩文字取「等效的字号」。
  • UI 组件与图形(成功标准 1.4.11)——≥ 3 : 1。涵盖边框、聚焦环、图标、图表线条等非文字视觉元素。WCAG 2 在此处未规定 AAA 阈值。

用 Ant Design 的主色检查主按钮

Ant Design 的主色 colorPrimary 默认是 #1677ff,主按钮的文字色取 colorTextLightSolid,默认就是白色 #fff(见 antd 6.6.5 源码 theme/themes/seed.js 与 button/style/token.js)。在工具里把前景填 #ffffff、背景填 #1677ff,对比度是 4.10 : 1:正文 AA 不通过,大号文字 AA 和 UI 组件 AA 通过。这时给出的修正是 #131313(4.52 : 1)。原因是工具只改前景,白色没有色相,只能往黑色方向找。

如果想保留白字、把按钮的蓝色调深一点,先点交换按钮,让 #1677ff 成为前景。对比度不变,仍是 4.10 : 1;修正建议变成 #086FF7(4.53 : 1),色相还是同一种蓝。对比度对前后景是对称的,所以这个值放回按钮背景、上面写白字,同样是 4.53 : 1。

错误色 colorError 的默认值 #ff4d4f 写在白底上是 3.26 : 1,大号文字 AA 通过。如果拿它写表单报错这类小于 24 px 的文字,要看正文那一列,不通过;建议值 #E22D37(4.50 : 1)仍是红色。

适老化规范里的对比度

工业和信息化部办公厅 2021 年 4 月 6 日印发的通知附有《移动互联网应用(APP)适老化通用设计规范》,其中 1.3 对比度一条写道:「文本/文本图像呈现方式、图标等元素间的对比度至少为4.5:1(字号大于18 dp/pt时文本及文本图像对比度至少为3:1)。」

这条和 WCAG 有两处不同。第一,大字的门槛是字号大于 18 dp/pt,不分粗细;WCAG 是 18 点常规或 14 点粗体,即 24 px 或 18.66 px。dp/pt 是 Android、iOS 的界面单位,WCAG 的「点」是印刷点(1 点 = 4/3 CSS px),所以两个数字不能直接比较。用本工具判断 APP 时,字号大于 18 dp/pt 的文字看「大号文字 AA」那一格(3:1),正好 18 dp/pt 及更小的文字看「正文 AA」(4.5:1)。第二,图标和文本写在同一句里,门槛也是 4.5:1;工具的「UI 组件」卡只按 WCAG 1.4.11 的 3:1 判断,所以图标请看「正文 AA」。

中文输入法在全角状态下,打出来的是 #767676 这样的全角字符。工具先按 NFKC 换成半角再读取,得到的结果与 #767676 相同:白底上 4.54 : 1,正文 AA 通过。

为什么是「保留色相、调整亮度」

品牌色与设计 token 通常按色相身份选定,而非按亮度。当对比不达标时,直接换成纯黑或纯白会破坏视觉语言。本工具沿前景的 OKLCH 亮度轴(感知均匀)行进,保留原始色相与色度,在第一个达到 4.5 : 1 的亮度处停下。每个候选色先取整为 8 位 HEX 再判定对比度,复制出去的 HEX 本身就达标。结果是离原色最近、且能通过正文 AA 的颜色。若该色相在 sRGB 色域内无法达成目标,工具回退到通过的纯黑或纯白。

限制

  • 只读不透明的 HEX。rgb()、hsl()、颜色名和透明度都不读;rgba(0,0,0,0.88) 这类带透明度的文字色,要先和背景混合成不透明色再检查。其他格式可先用颜色转换器转成 HEX。
  • 一次只比较一对颜色。图片、渐变上的文字没有单一背景色,请分别检查文字后面最亮和最暗的地方。
  • 修正建议只改前景,目标是正文 AA(4.5 : 1),不追求 AAA(7 : 1)。
  • 工具不知道文字的字号和粗细,哪一列适用由你按实际字号判断。

隐私

HEX 解析、OKLCH 转换、对比度计算、修正搜索全部在浏览器本地执行,颜色不会上传,也不会保存。页面统计只记录工具名与 check 这类动作。

相关工具

FAQ

本工具遵循 WCAG 哪个版本?

采用 WCAG 2.1 / 2.2 基于相对亮度的对比度公式。阈值:正文 AA 4.5:1、AAA 7:1;大号文字 AA 3:1、AAA 4.5:1;UI 组件与图形 3:1(成功标准 1.4.11)。WCAG 2.2 在 2021 年把线性化分界从 0.03928 改为 0.04045,8 位通道值没有落在两者之间的,所以同一对 HEX 的结果不受影响。

支持哪些输入格式?

三位或六位十六进制,可带可不带 #,大小写均可(#1f2937、1F2937、#abc 都行,#abc 扩展为 #aabbcc)。中文输入法全角状态下打出的 #1F2937 会按半角读取。带透明度的四位或八位 HEX 会提示「不支持透明度」,因为半透明颜色没有唯一的对比度。每个输入框旁的原生取色器设置的是同一个值。

修正建议是怎么算出来的?

当正文 AA(4.5:1)未通过时,工具在 OKLCH 空间保留前景的色相与色度,对亮度做二分搜索,找到与当前背景达到 4.5:1 的最近亮度值,每个候选色先取整为页面显示与复制的 8 位 HEX,再按这个 HEX 计算对比度,所以建议值本身就达标(例如 #D97706 在 #FFF7ED 上建议 #B75700,4.51:1)。若该色相在 sRGB 色域内无法达到 4.5:1,工具回退到通过的纯黑或纯白。工具只调前景;想调背景,先点交换按钮。

工具会上传我的颜色数据吗?

不会。对比度和修正建议都在浏览器里计算,颜色不会发送到服务器,也不会写入浏览器存储。页面统计只记录工具名和动作(check、swap、apply、copy_fix),不包含颜色值。

APCA / WCAG 3 呢?

本工具输出 WCAG 2.x 对比度——这是当前法律依据的标准;APCA 仍处于草案阶段,需要 APCA 工作流请使用 Myndex 官方工具。

APP 适老化改造按什么对比度?

工信部办公厅 2021 年 4 月印发的《移动互联网应用(APP)适老化通用设计规范》1.3 要求文本、文本图像、图标等元素的对比度至少 4.5:1,字号大于 18 dp/pt 的文本及文本图像至少 3:1。这里的 dp/pt 是 Android、iOS 的界面单位,WCAG 的 18 点是印刷点(1 点 = 4/3 CSS px),两个门槛不能按数字直接比较;图标也按 4.5:1。用本工具时,字号大于 18 dp/pt 的文字看「大号文字 AA」,其余文字(包括正好 18 dp/pt 的)和图标看「正文 AA」。