首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >你以为看得清的浅灰字,对比度其实挂了三科|数据鱼API

你以为看得清的浅灰字,对比度其实挂了三科|数据鱼API

原创
作者头像
用户12862874
发布于 2026-11-18 21:42:54
发布于 2026-11-18 21:42:54
40
举报

上周把登录页的用户协议那行小字换成了浅灰色,自我感觉挺"高级"。第二天测试同事把截图甩过来:她把系统字号调大一档,那行字直接和背景融为一体,找都找不到。我还嘴硬"设计稿就这样",她把设计稿打开一量——设计稿也不行。行吧。这事给我结结实实上了一课:看得清看不清,我的眼睛说了不算。

下面拿数据鱼API的「颜色对比度检测」服务当例子。它只收前景色和背景色两个参数,返回对比度比值外加四档判定,专治各种"我看着挺清楚"。

眼睛投票不算数,数字才算数

无障碍领域对"看得清"有一套通行的数学标准:普通字号的正文,前景与背景的亮度对比至少要 4.5 比 1;大字号放宽到 3 比 1;想够到更严的档位,这两个数分别是 7 比 1 和 4.5 比 1。这套阈值不是玄学,它背后是低视力用户、强光环境、廉价屏幕的真实处境——你在空调房里看得清清楚楚,不代表外卖骑手在正午太阳底下也看得清。

数据鱼API的这个对比度端点把判定直接拆成四个布尔字段,谁过谁挂,一目了然:

字段

通行阈值

对应场景

wcag.AA_normal

4.5:1

普通字号正文

wcag.AA_large

3:1

大字号文本

wcag.AAA_normal

7:1

普通字号的严苛要求

wcag.AAA_large

4.5:1

大字号的严苛要求

还有个啼笑皆非的细节:我头一回调用忘了传参数,返回 ratio 是 1,四个布尔全是 false。对比度 1 比 1,意思是前景和背景同一个颜色——全挂,合理,服务没坏,是我的锅。这个空转输出倒是帮我确认了口径:比值越接近 1 越糟,越大越稳。

再补一个容易误读的点:这四个布尔字段是同一个比值对四条线各判一次,彼此并不递进。比值 3.5 的时候,AA_large 是 true,AA_normal 和 AAA_large 却都是 false。所以"AA 通过"不等于"无障碍达标",前端做门禁要按字号去读对应字段,别拿 AA_normal 一个字段当总开关。

两个参数,把评审会上的架吵完

端点 GET、POST 都支持,参数就 fg 和 bg 两个,把前景色、背景色传进去,响应里是算好的 ratio 和上面那张判定表。以前评审会为了"这灰够不够深"能吵二十分钟,谁嗓门大听谁的;现在发一次请求,数字往桌上一摆,三秒钟散会。

我的用法粗暴但有效:设计给一版配色,我先把正文、辅助说明、按钮文字三组组合各测一遍,挂科的当场打回,附上比值和档位。有数字垫底,打回都不用委婉——不是我觉得丑,是 4.5 这条线觉得不行。数据鱼这个接口把算数这步收走了,剩下的人和事反而都体面了。

真正的重灾区在细节里

  • 占位符和辅助说明文字最爱用浅灰,也最容易挂在 4.5:1 这条线上;
  • 按钮禁用态、标签描边这类"低对比是故意的"地方,豁免也要讲边界,正文可借不了这个光;
  • 深色模式切换后,浅色模式达标的组合常常直接翻车,两套主题要各自测一遍;
  • 大字号豁免(3:1 那档)只对真正的大字号生效,别拿"以后会调大"当挡箭牌。
代码语言:javascript
复制
GET /api/a11y-color/contrast?fg=888888&bg=ffffff

对比度挂科不代表审美不行,只代表这组颜色扛不住低视力场景。把判定交给接口,把争论留给真正需要取舍的地方——比如品牌色要不要为更高的档位让步。数字给底线,人做末尾那一步的判断。

以上参数与返回结构,整理自数据鱼API「颜色对比度检测」接口的公开文档;示例色值为演示用。检测结果仅供参考,最终表述请人工复核并以最新法规为准。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 眼睛投票不算数,数字才算数
  • 两个参数,把评审会上的架吵完
  • 真正的重灾区在细节里
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档