颜色对比度检查指南:WCAG 比值、AA/AAA 与透明度
Admin ·
颜色对比度检查器比较前景色与背景色的相对亮度。ToolMellow 计算 WCAG 2.2 的 sRGB 对比度,并显示普通文字、大号文字和必要非文字内容的五项阈值结果。修改文字颜色、背景颜色或透明区域后的底色,浏览器便会立即重新计算。
结果描述的是输入的纯色组合经过本工具透明度合成后的对比度。用它选择并记录颜色,再检查实际内容、字体排印、相邻表面和交互状态。组合通过检查只是无障碍证据的一部分,不能代替完整网站审核,也不能保证每位读者都会觉得文字阅读舒适。
如何检查文字与背景组合
输入实际文字和背景的颜色值。文字颜色初始为 #294C39,背景颜色与透明区域后的底色均为 #FFFFFF。在所支持的语法范围内,可输入 CSS 名称、HEX、RGB/RGBA 和 HSL/HSLA。即使更改界面语言,颜色值仍须采用 CSS 语法。
查看比值和与预定用途对应的结果行。修改颜色或底色会立即重新计算;无效值会显示错误,并隐藏报告和预览,直到输入恢复有效。预览文字、字号(px)和粗体文字用于查看示例。复制报告和下载报告保存的是当时计算结果的快照。
- 使用实际元素与表面采用的颜色,包括相关主题和状态。
- 有透明度时,应确定下面的不透明表面,不要假设页面为白色。
- 保存颜色组合与完整精度结果,在修改共享设计变量前检查实际组件。
五项结果:普通文字、大号文字与必要图形
下表列出本工具包含边界值的最低比较要求:未经舍入的比值必须达到所列数值。普通文字和大号文字各有 AA 与 AAA 结果行。必要界面与图形行采用与非文字对比度相关的 3:1 比较;具体部件或状态是否适用,仍须结合实际情境判断。
更改预览字号或粗细时,五行结果始终显示。预览中的普通或大号文字提示不会替换结果表,也不会提高比值。普通文字通过 AA 不代表自动通过 AAA;大号文字的通过结果也不能用于字号较小的正文。
| 用途 | 最低比值 | 报告标记 |
|---|---|---|
| 普通文字 · AA | 4.5:1 | normalAA |
| 普通文字 · AAA | 7:1 | normalAAA |
| 大号文字 · AA | 3:1 | largeAA |
| 大号文字 · AAA | 4.5:1 | largeAAA |
| 必要界面与图形 · AA | 3:1 | nonTextAA |
W3C WCAG 2.2:准则、大号文字、相对亮度与对比度W3C 理解 1.4.3:对比度(最低)W3C 理解 1.4.6:对比度(增强)W3C 理解 1.4.11:非文字对比度
比值测量什么,以及为何不能忽略舍入
对每个有效 sRGB 通道,先取 c = channel / 255。当 c <= 0.04045 时,工具用 c / 12.92,否则用 ((c + 0.055) / 1.055) ^ 2.4,得到线性值。使用这些线性 R/G/B 值计算相对亮度:L = 0.2126R + 0.7152G + 0.0722B。对比度为 (Llighter + 0.05) / (Ldarker + 0.05)。比值从亮度相等时的 1:1 到黑白之间的 21:1;它不是 HEX 字符串或色相名称的差异。
界面按所选语言的数字格式显示两位小数,但通过与否比较的是完整计算值。略低于 4.5 的值可能显示为 4.50:1,却仍未达到普通文字 AA。应比较报告中的数值与阈值,不要将显示值向上舍入。有效背景的 HEX 也仅为显示而舍入,实际计算保留合成后通道的小数值。
大号文字:磅、CSS 像素与预览标记
WCAG 的大号文字定义包括 18 磅文字或 14 磅粗体文字,并对等效中日韩(CJK)字号及细笔画、特殊字体作出说明。CSS 绝对单位规定每英寸 96 像素与 72 磅:18 磅对应 24 CSS 像素,14 磅约为 18.67 CSS 像素。屏幕的物理像素、图像编辑器的像素密度设置不能与这些 CSS 字号互换。
预览初始使用 16 CSS 像素、正常字重。字号(px)限制在 10–72,粗体文字使用字重 700,普通使用 400。大号文字标记要求字号至少为 24,或粗体字号至少为 18.6666666667。这是预览规则,不会自动识别实际字体度量或具体文字系统的等效字号。实际排印与内容须另行判断。
| 预览设置 | 预览分类 | 仅由字号/粗细引起的比值变化 |
|---|---|---|
| 16 px,普通 | 普通文字 | 无 |
| 24 px,普通 | 大号文字 | 无 |
| 18.66 px,粗体 | 按本工具界限仍为普通文字 | 无 |
| 18.67 px,粗体 | 大号文字 | 无 |
W3C WCAG 2.2:准则、大号文字、相对亮度与对比度W3C CSS Values and Units 4:绝对长度
不透明 sRGB 颜色的计算示例
在不透明白色底色上,输入下表中的准确前景与背景值。表中比值使用英语界面的两位小数表示法,结果标记则来自完整计算。灰色示例说明,通道值的小幅变化可能越过阈值,而视觉差异看起来并不明显。
这些是颜色组合的计算示例,并非适用于所有场景的配色建议。修改一个共享设计变量可能影响其他元素、主题和状态。不透明黑字配白底得到最大比值;白字配同样白底得到 1:1。默认绿色组合达到全部五项数值阈值,但用于实际组件时仍须检查情境。
| 文字颜色 | 背景颜色 | 显示比值 | 普通文字 AA / AAA |
|---|---|---|---|
#000000 | #FFFFFF | 21.00:1 | 通过 / 通过 |
#FFFFFF | #FFFFFF | 1.00:1 | 未通过 / 未通过 |
#777777 | #FFFFFF | 4.48:1 | 未通过 / 未通过 |
#767676 | #FFFFFF | 4.54:1 | 通过 / 未通过 |
#294C39 | #FFFFFF | 9.60:1 | 通过 / 通过 |
透明度:先合成背景,再合成文字
透明区域后的底色是选择不透明 HEX 颜色的控件。工具先把背景颜色合成到该底色上,再把文字颜色合成到有效背景上。完成这两步后才计算相对亮度和对比度。十进制 alpha 得到保留,合成通道的小数值不会在此次计算前舍入。
半透明黑字配不透明白底时,有效文字通道为 127.5,显示比值为 3.98:1。若白色背景半透明并位于黑色底色上,有效背景通道为 127.5,同样的半透明黑字变为 63.75,得到 2.62:1。这些变化来自实际叠层,不是字号。
| 叠层示例 | 有效背景 RGB | 有效前景 RGB | 显示比值 |
|---|---|---|---|
rgba(0,0,0,0.5) 配 #FFFFFF,白色底色 | 255,255,255 | 127.5,127.5,127.5 | 3.98:1 |
rgba(0,0,0,0.5) 配 rgba(255,255,255,0.5),黑色底色 | 127.5,127.5,127.5 | 63.75,63.75,63.75 | 2.62:1 |
交换颜色与十进制或 HEX alpha
交换颜色会交换前景与背景的原始输入,并保留底色。不透明颜色的亮度比具有对称性,交换后比值不变。存在透明度时,叠层角色改变,比值可能变化;应检查交换后的结果,不要假设分数相同。
HEX alpha 是 8 位数值。例如 #0008 展开为 #00000088,alpha 为 136/255,不同于 rgba(0,0,0,0.5) 中的十进制 0.5。保留样式表所需的表示形式。alpha 或合成颜色经舍入后的 HEX 表示不一定能精确替代原始十进制输入。
W3C CSS Color 4:命名颜色、sRGB 与 alphaW3C Compositing and Blending Level 1:简单 alpha 合成
支持的颜色语法与输入量化
解析器接受 148 种标准 CSS 命名颜色拼写以及 transparent,名称不区分大小写;接受可带前导 # 的 3、4、6 或 8 位 HEX;也接受数字形式的 RGB/RGBA、HSL/HSLA 函数。在其语法范围内支持逗号形式和空格/斜杠形式。HSL 饱和度、明度必须使用百分比,色相可使用度、百分度、弧度或圈数。
合成前,RGB 通道和转换后的 HSL 通道会舍入为整数的 8 位 sRGB 值,十进制 alpha 仍保留为数值小数。超出范围的通道或 alpha 会被拒绝,并不遵循 CSS 的所有裁剪规则。不支持依赖上下文的名称、currentcolor、自定义属性表达式、calc()、相对颜色以及 Lab/Oklab 或广色域函数。请使用所支持的实际 sRGB 值,不要将它视为完整 CSS 求值器。
| 形式 | 支持的示例 | 需区分的含义 |
|---|---|---|
| 命名颜色 | RebeccaPurple | CSS 关键字,不是翻译后的颜色描述 |
| HEX | #294C39 | 四位/八位也编码 8 位 alpha |
| 逗号 RGBA | rgba(0,0,0,0.5) | 保留十进制 alpha |
| 空格/斜杠 RGB | rgb(0 0 0 / 50%) | 数字通道及可选 alpha |
| HSL | hsl(120deg 100% 25%) | 饱和度/明度使用百分比;结果为量化后的 sRGB |
检查实际背景、字体和交互状态
纯色组合是输入颜色的模型。图像、渐变、叠加层、祖先元素的不透明度、混合模式和滤镜可能产生不同的相关表面或渲染颜色。检查实际样式表和视觉情境,再评估各主题、状态中需要比较的组合。本工具不会获取网页、检查 DOM 或采样背景图像。
抗锯齿可能让字形边缘像素比预定文字颜色更浅。WCAG 文字指南要求以实际指定的前景与背景颜色进行评估,不应将柔化后的边缘像素作为文字值。仍须用实际字体检查可读性,并在适当情况下留出高于阈值的实际余量;一个比值不能评估全部视觉或交互障碍。
用非文字结果行检查相关相邻颜色
成功准则 1.4.11 涉及识别所涵盖控件、状态和图形对象所必需的视觉信息与相邻颜色之间的对比。通用的 3:1 行不能替你选择这些组合。对于按钮,标签文字的对比度与识别组件或状态的视觉信息,可能需要不同的比较。
该准则有依情境适用的例外,包括未启用组件,以及某些未修改的用户代理呈现或传达信息所必需的特定呈现。焦点指示器还须按适用的焦点准则评估;nonTextAA 标记不是完整焦点评估。先确定哪些视觉信息是必需的,再把孤立的数值结果作为证据。
改善未通过的组合并检查受影响用途
有目的地调整前景、背景或不透明度,并观察实时计算。浅色表面上加深前景、深色表面上调亮前景,或减少不需要的透明度,都可能有帮助,但应检查实际结果,不能只凭颜色名称或 HSL 明度判断。工具报告你作出的修改,不会自动选择替代颜色。
选择通过的组合后,重新检查各设计变量的使用位置。改变强调色可能改善一个标签,却降低它与另一表面的对比度。用实际背景测试正文、链接和相关状态,并保留明确的层次和不依赖颜色的提示。
- 按实际字号、粗细或必要图形信息选择结果行。
- 检查每个相关主题和状态,不要只看默认预览。
- 记录结果值,在广泛修改配色前先在实际组件中检查。
复制或下载完整精度 JSON 报告
在权限和浏览器支持允许时,复制报告会将 JSON 写入剪贴板。复制失败时可使用下载报告,将 application/json 保存为 toolmellow-contrast.json。报告保留原始前景、背景、底色输入;比值;五项阈值;有效 RGB 值与结果标记;预览字号、bold、largeText;以及计算方法。
JSON 键和数值是技术数据,在不同界面语言中保留机器可读形式。自定义预览文字不包含在导出对象中。修改后须重新复制或下载:文件和剪贴板条目都是快照,页面实时更新不会改写以前的导出。JSON 提供颜色组合计算证据,不是合规证书或自动审核历史。
限制、无效值与本地状态
文字颜色和背景颜色字段最多允许 200 个 UTF-16 单元,预览文字最多 300 个。底色使用不透明的浏览器原生颜色控件;预览字号限制在 10–72 CSS 像素。无效颜色语法或不支持的范围会显示错误,并隐藏报告和导出控件。修正输入即可恢复计算;预览设置仍保留在页面状态中。
颜色解析和比值计算在本页面同步执行,不会将输入的颜色组合或预览文字发送到计算服务器。刷新或离开页面会丢弃内存状态;下载的报告、剪贴板内容不属于该状态。公共网站仍会发出普通托管和分析请求。本地计算不意味着匿名,也不意味着基础设施完全不记录日志。
嵌入检查器并保留反向链接
在工作区下方的集成部分复制或下载所提供的本地化 HTML 代码片段。将它粘贴到允许 iframe 和尺寸调整脚本的平台,并保留指向对应 ToolMellow 颜色对比度检查页面的可见反向链接。所提供的署名链接使用 nofollow 和 noopener。
在窄屏上测试嵌入布局,并检查嵌入环境中的剪贴板行为。iframe 保留相同的实时组合计算、输入与限制。高度消息用于调整工作区尺寸,不是扫描宿主页面样式或批量发送对比度请求的 API。
常见问题
如何检查颜色对比度?
输入实际文字颜色和背景颜色,为透明区域选择下面的不透明底色,再查看自动更新的比值和适当的阈值行。采用实际组件的颜色与情境。
WCAG AA 与 AAA 对文字要求什么比值?
本工具将普通文字与 AA 的 4.5:1、AAA 的 7:1 比较,将大号文字与 AA 的 3:1、AAA 的 4.5:1 比较。比较包含边界且不舍入;实际准则是否适用须另行判断。
为什么显示 4.50:1 仍可能未通过?
显示值保留两位小数,通过与否采用完整比值。略低于 4.5 的计算值可能在屏幕上舍入为 4.50,仍未达到普通文字 AA。检查 JSON 中的数值结果。
此预览中什么算大号文字?
标记要求至少 24 CSS 像素,或粗体至少 18.6666666667 CSS 像素。实际排印仍须检查 WCAG 对磅数、等效字号及字体的说明。
粗体文字会提高对比度吗?
不会。它改变预览字重,可能改变普通/大号分类;比值仍由输入的颜色组合确定。全部五项阈值行始终显示。
透明文字如何影响对比度?
背景先合成到所选不透明底色,文字再合成到该有效背景。比值使用最终颜色,并保留合成通道的小数值。
为什么交换颜色会改变透明组合的比值?
它交换前景/背景角色并保留底色。透明度让合成顺序影响结果。不透明组合的比值对称;透明组合交换后须检查。
#0008 与半透明黑色相同吗?
不同。#0008 的 alpha 为 136/255,十进制 RGBA alpha 0.5 则正好为一半。HEX alpha 是 8 位表示,可能与十进制 alpha 输入不同。
能输入任意 CSS 颜色表达式吗?
不能。解析器支持命名 sRGB 颜色、HEX 和数字 RGB/HSL 形式,不支持依赖上下文的表达式、变量、计算、相对颜色或更广色彩空间函数。
通过结果证明整个页面符合 WCAG 吗?
不能。它检查输入组合的数值比较。实际字号、相邻颜色、状态和其他适用的无障碍准则仍须审核;本工具不会扫描 URL 或 DOM。
能用于渐变或图像上的文字吗?
它计算纯色组合,不会分析图像或渐变。先另行确定相关实际背景颜色和情境,再判断哪些比较能证明满足要求。
为什么对比度计算器结果不同?
检查指标、解析后的颜色值、RGB/HSL 量化、alpha 和底色、合成顺序及舍入。本工具采用 WCAG 2.2 sRGB 比值,不采用 APCA 或其他对比度指标。
JSON 包含我自定义的预览句子吗?
不包含。它包含颜色输入、比值、阈值、有效 RGB/结果标记、预览字号/bold/largeText 和方法。下载报告保存 toolmellow-contrast.json;修改输入后须重新导出。
能将检查器嵌入网页吗?
使用工作区下方的本地化 HTML 片段,保留可见 ToolMellow 反向链接,并测试 iframe、脚本和剪贴板支持。它仍是组合计算工作区,不是宿主页面扫描器或审核 API。