该技能旨在修复 PageSpeed Insights/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 验证。
提供快速扫描命令,例如搜索 backdrop-blur、filter、mix-blend-mode、oklch、oklab、低透明度类名以及 background-clip 与透明文字的组合。
修复模式示例包括:移除滤镜,将背景透明度从 /50 提高到 /80;将 OKLCH 变量转换为 HSL;背景透明度不低于 0.4(建议不低于 0.6),将 /10、/20 改为 /40,/30 改为 /60;渐变文字添加纯色回退,并在强制颜色模式下回退为 CanvasText;图片上文字添加黑色半透明遮罩。
验收标准:可访问性分数为数值而非“!”;color-contrast 审计通过或列出可操作项;正常文本对比度不低于 4.5:1,大文本不低于 3:1。注意“!”表示审计失败而非低分,始终先在本地测试再等待 PSI 更新。