设计评审会上吵起来了。深色模式走查,一块浅灰字在深底上明显发虚,设计师要求整改;前端把色值丢进老检测工具,对比度过线,结论是「合规,不用改」。两边都没算错——错在用的口径老了。这种架每个月都会在不同团队里打一遍,值得把两套口径摆在一起讲清楚。
下面拿数据鱼API的「APCA 文字对比度计算」服务当例子。它的 calc 端点一次返回两套口径的结果:传统 WCAG 对比度,和感知更贴近人眼的 APCA。
老口径:一个比值管所有场景
WCAG 2.x 的对比度是传统方案:算出一个比值,正文达到 4.5:1 这条线就合格。它的优点很实在——简单、工具普及、合规材料里引用方便。缺点在深色模式上暴露得最彻底:深底浅字和浅底深字在老公式里被一视同仁,而人眼对这两种场景的感知差异很大;细字重、大标题与小正文需要的对比度也不同,一个统一阈值照顾不过来。于是前端拿着「达标」的结论,设计师看着「发虚」的界面,谁也说不服谁。
新口径:换个问法——这段文字好不好读
APCA 换了思路:不再只给一个比值,而是按这段文字的实际用途来分级。数据鱼这个接口的 calc 端点按文档说明不接收请求参数,返回示例即黑字白底(txt_color 为 #000000、bg_color 为 #FFFFFF)这一基准组合:contrast 字段给出 APCA 的 Lc 值 108.74,rating 字段直接写成人话——"Lc 90 - Preferred for body text",九十级,适合正文;同时 wcag_ratio 字段给出传统口径的比值 21。
对比一下两种口径的差异:
维度 WCAG 对比度 APCA
输出形式 一个比值 Lc 值加用途评级
判断方式 对固定阈值 按文字用途分级
深色模式表现 容易误判 感知更贴近人眼
生态现状 标准成熟,工具普及 新口径,生态在铺开
返回体的字段不多,四行值得逐个对一遍:
字段 示例值 含义 用法
contrast 108.74 APCA 的 Lc 值 与评级一起读,别单独比大小
rating Lc 90 - Preferred for body text 按用途给出的结论 可直接当整改依据
txt_color / bg_color #000000 / #FFFFFF 本次计算用的文字色与背景色 先核对算的是哪一组颜色
wcag_ratio 21 传统口径的对比度比值 写合规材料时引用
四行里最容易被误用的是第一行。Lc 值不能跨用途直接比大小:正文要的分量和装饰性文字要的分量不是一回事,脱离 rating 单看数字,等于又退回到老口径的一刀切。第二行的评级是给人看的人话,可以直接抄进评审记录,比「对比度不足」这种模糊结论好沟通得多。第三行提醒你这次算的是哪一组颜色——示例给的是黑字白底,落到自己的设计稿上,先确认色值没取反。第四行留给合规材料,老口径的比值仍是当下最好用的通行证。
迁移期最实用的解法:两套一起看
迁移期的务实做法不是二选一。交付合规材料引用老口径,设计走查用新口径;两边结论不一致时,相信自己的眼睛,再回头核参数。评审记录里建议两行都写上:一行记 Lc 与评级,一行记 WCAG 比值,设计与合规各取所需,谁看都能对上号。数据鱼API的这个 calc 端点把两个口径并列返回,正是为迁移期准备的读法——一次调用,左手比值,右手评级,谁也不必说服谁,屏幕前的用户说了算。
对比度工具的意义不是给整改找理由,而是让「看不清」在上线前被发现。口径会更新,这个目的不会变。
以上字段与示例说明,整理自数据鱼API「APCA 文字对比度计算」接口的公开文档;文中数值为文档示例,阈值判断请以 WCAG 与 APCA 官方规范为准。