Web Performance SEO 是一个针对无障碍色彩对比问题的修复技能,主要解决 PageSpeed Insights(PSI)或 Lighthouse 无障碍审计中出现的“!”错误。资料说明,“!”表示审计执行失败,并非分数偏低。
适用时机:PSI/Lighthouse 无障碍结果中显示“!”或错误而非数值分数;color-contrast 审计报错或出现 getImageData 失败;需要改善影响 SEO 的无障碍信号。
工作流程:
- 复现:运行 Lighthouse 或 PSI,记录失败的审计项名称。
- 扫描代码中的常见触发因素:CSS 滤镜/背景模糊与 mix-blend-mode;OKLCH/OKLAB 色彩;低不透明度背景(低于 0.4);使用 color: transparent 的渐变文字;没有不透明遮罩的图片上文字。
- 按优先级修复:移除滤镜/混合模式;将 OKLCH/OKLAB 转换为 HSL/RGB;提高不透明度阈值;为渐变文字添加纯色回退;为图片上的文字添加遮罩层。
- 用 Lighthouse/axe 在本地验证,部署后再用 PSI 复核。
技能提供了快速扫描命令,例如用 rg 检索 backdrop-blur、filter:、mix-blend-mode、oklch/oklab、/10 /20 /30、opacity-25、opacity-0、background-clip 与 color transparent 等模式。
修复示例包括:将带有 bg-card/50 backdrop-blur-sm 的容器改为 bg-card/80;把 :root 中的 oklch(0.55 0.22 264) 改为 hsl(250, 60%, 50%);背景不透明度建议不低于 0.4(最好不低于 0.6),如把 /10、/20 改为 /40,把 /30 改为 /60;渐变文字先给出 #111111 等纯色,再在 prefers-contrast: no-preference 下启用渐变与 background-clip: text,并在 forced-colors: active 下回退为 CanvasText;图片上文字则叠加 bg-black/60 遮罩并提升文字层级。
验收标准:无障碍分数为数值而非“!”;color-contrast 审计通过或列出可操作项;普通文字对比度不低于 4.5:1,大号文字不低于 3:1。
限制:资料仅涉及前端 CSS 与页面结构的对比度修复,未提供其他性能指标优化、后端改动或自动修复工具;所有示例需结合项目实际情况调整,部署后 PSI 结果更新可能有延迟,因此建议先在本地验证。