让浏览器自动挑一个可读的前景色听起来很理想,也确实能减轻设计系统的负担。但它是受限场景的辅助工具,不是可访问性审计的替代品。

01函数解决的具体问题

contrast-color() 针对给定背景色返回一个满足对比要求的前景色,常用于由主题变量或用户自定义色动态生成按钮、标签与状态块。它能减少「每个背景配一个手工前景色」的穷举,也避免品牌色一改就要重算几十组配对。对多主题、白标签与允许用户换色的产品,收益最直接。

需要注意「自动对比色」并不适用于所有场景。先确认访问者的真实任务与设备分布,再决定是否引入;如果一个能力只服务于装饰效果,却让核心内容依赖它,那它就从增强变成了单点故障。

02边界在哪里

自动结果只保证颜色对,不保证语义对:错误态仍应是明确的错误色,选中态仍要与未选中区分;渐变、图片背景、半透明叠加与相邻色的干扰都不在单一取值的判断范围内;hover、focus、disabled、selected 的组合状态必须逐一验证。此外强制颜色模式下颜色会被系统覆写,状态仍需靠文字或边框表达。

需要注意「自动对比色」并不适用于所有场景。先确认访问者的真实任务与设备分布,再决定是否引入;如果一个能力只服务于装饰效果,却让核心内容依赖它,那它就从增强变成了单点故障。

03推荐的落地方式

把函数放在特性查询里,先给出一组已验证的显式回退色;为关键组件保存人工确认过的配对,自动结果只用于确实动态生成的部分;在 CI 里对最终计算值做一次对比度校验。设计文档中写清「哪里允许自动选色、哪里必须人工指定」,比全站无差别使用更可控。

需要注意「自动对比色」并不适用于所有场景。先确认访问者的真实任务与设备分布,再决定是否引入;如果一个能力只服务于装饰效果,却让核心内容依赖它,那它就从增强变成了单点故障。

要点速览

  • 适合动态主题、用户自定义色与白标签场景的配对生成
  • 不保证语义正确,也不覆盖渐变、图片与半透明背景
  • 状态组合与 forced-colors 仍需逐一验证
  • 放在 @supports 内并保留显式回退与计算值校验

工具负责算数,判断仍然要由人来做。