实务专题 · 交付验收

文字对比度接近门槛,也不能四舍五入成通过

柔和灰字可以是品牌选择,但截图评价前应先明确验收口径。确定文字类别和真实前后景,再按相应比值判断,不能把差一点的数值向上四舍五入。视觉判断与数值门槛是两种证据。

适用读者与交付决定

采用克制灰度排版的品牌网站。把本题作为网站供应方的有限验收任务;实际系统证据不能由教学例子替代。

官方依据与解释边界

WCAG最小对比度对普通文字为4.5:1,符合定义的大字为3:1,并有明确例外;门槛比值不能向上舍入。 W3C: contrast minimum · 核对日期:2026年10月16日。

已填写教学例子

合成例子,不是真实客户案例。 列出有限输入、预期结果及反例,不代表已完成真实平台集成。

窄屏可横向滚动表格。

输入/情况检查口径预期结果
ordinary text ratio4.499门槛4.5未达
ordinary text ratio4.5门槛4.5比值满足
large qualifying text ratio3门槛3比值满足

怎样执行验收

  1. 批准文字字号字重类别与配色。
  2. 测量真实渲染组合,包含叠层及相关状态。
  3. 保留未舍入结果,再在目标设备检查阅读体验。

如何解释结果与保留证据

检查器只比较给定比值和选定门槛,不计算颜色亮度,也不判断是否属于大字。图片背景或叠层可能需要多点取样。不能把一次数值通过宣传为整站无障碍通过。

适用边界

不改旧配色、字体或布局;不覆盖标识例外、完整WCAG审查或所有人舒适阅读保证。

离线复核

把下方两份文件存入同一目录,以Node22.13或更新版本运行。示例不联网、不修改任何账号或网站。 已填输入与预期输出 · 可检查的函数

node decision-check.mjs text-contrast-acceptance-threshold.json