网页内容无障碍指南(WCAG)2.1 设定了严格的量化阈值,以确保中度视力障碍或色觉缺陷人士能够顺畅辨识文本信息与界面结构。评估色彩是否合规,核心在于精确计算前景色与承载它的背景色这两个纯色图层之间的相对亮度比率。
WCAG 2.1 对比度阈值准则
- 常规文本 AA 级(最低对比度):字号小于 18 磅(24px)的标准正文文本或小于 14 磅(约 18.66px)的粗体文本,最低对比度比率必须达到
4.5:1。 - 常规文本 AAA 级(增强对比度):标准正文排版必须达到至少
7.0:1的对比度比率。 - 大号文本 AA 级:字号大于等于 18 磅(24px)的常规字重文本,或大于等于 14 磅(18.66px)的粗体文本,对比度比率至少需达
3.0:1。 - 大号文本 AAA 级:大号排版文本对比度比率至少需达
4.5:1。 - 图形对象与用户界面组件(AA 级):表单输入框边框、可交互按钮轮廓、键盘聚焦指示环以及承载关键信息的图表图形,与其相邻背景的对比度比率至少需达
3.0:1。
生产环境设计令牌示例
在现代设计系统中定义颜色令牌时,建议将通过无障碍审查的颜色配对映射至语义化 CSS 自定义属性中,以确保主题切换时始终符合法律合规要求:
:root {
/* 表面背景令牌 */
--color-surface-canvas: #ffffff;
--color-surface-subtle: #f8fafc;
--color-surface-inverted: #0f172a;
/* 文本令牌 - 在纯白画布上符合 WCAG AAA 标准(比率 > 7.0:1) */
--color-text-primary: #0f172a; /* 相对 #ffffff 达到 16.0:1 */
--color-text-secondary: #475569; /* 相对 #ffffff 达到 7.3:1 */
/* 文本令牌 - 在纯白画布上符合 WCAG AA 标准(比率 >= 4.5:1) */
--color-text-muted: #64748b; /* 相对 #ffffff 达到 4.6:1 */
/* 交互式 UI 组件令牌(比率 >= 3.0:1) */
--color-border-input: #94a3b8; /* 相对 #ffffff 达到 3.1:1 */
--color-focus-ring: #2563eb; /* 相对 #ffffff 达到 4.6:1 */
}
.btn-accessible {
background-color: var(--color-surface-inverted);
color: #ffffff; /* 16.0:1 比率 - 顺利通过 AAA 级 */
border: 1px solid var(--color-surface-inverted);
outline-offset: 2px;
}
.btn-accessible:focus-visible {
outline: 2px solid var(--color-focus-ring);
}
通过将排版色彩和边框色彩绑定到经过审计的设计令牌上,前端代码库能够有效避免在组件重构或浅色/深色模式切换过程中意外引发对比度回退缺陷。