高对比度模式适配:让文字在系统高对比下依然清晰

做网站美化时,我们把大部分精力花在"正常状态下好不好看",却常常忽略另一群读者:他们把系统调成了高对比度。对弱视、白内障,或者只是在强光下看手机的人来说,#718096 这种"高级灰"基本等于看不见。

这段代码的思路是对的——用 prefers-contrast 去响应系统的高对比设置。但实测下来有个很反直觉的结果:这个"高对比演示器",在系统真正开启高对比之后,自己先失效了。

下面每块都能点「预览效果」直接看。

原版 · 实际效果

HTML高对比度模式 · 原版实际效果
<style>
body{margin:0;padding:14px;background:#f6f7f9;font-family:-apple-system,"PingFang SC",sans-serif}
.ay-ct{background:#fff;border:1px solid #e8ecf1;border-radius:14px;overflow:hidden}
.ay-ct-t{display:flex;gap:0;border-bottom:1px solid #eef1f5}
.ay-ct-t button{flex:1;border:none;background:#fff;padding:9px 4px;font-size:11px;color:#718096;cursor:pointer;font-family:inherit}
.ay-ct-t button.on{background:#5b7cfa;color:#fff;font-weight:600}
.ay-ct-b{padding:15px}
.ay-ct-b h3{margin:0 0 9px;font-size:15px;color:#2d3748}
.ay-ct-b p{margin:0 0 10px;font-size:13.5px;line-height:1.85;color:#4a5568}
.ay-ct-b a{color:#5b7cfa;font-size:13.5px}
.ay-ct-c{display:flex;gap:8px;margin-top:11px}
.ay-ct-n{font-size:10px;background:#f7f9fc;color:#718096;padding:2px 9px;border-radius:20px}
.ay-ct-n.ok{background:#f0fff4;color:#276749}
@media(prefers-contrast:more){
  .ay-ct-b h3{color:#000}
  .ay-ct-b p{color:#000;font-weight:500}
  .ay-ct-b a{color:#0000ee;text-decoration:underline;text-decoration-thickness:2px}
}
</style>
<div class="ay-ct">
  <div class="ay-ct-t"><button class="on">普通</button><button>高对比</button><button>深色高对比</button></div>
  <div class="ay-ct-b">
    <h3>备案美化教程已更新</h3>
    <p>维形筑网的备案美化教程补上了 Typecho 版本。高对比模式会把正文颜色加深到接近纯黑,背景调至纯白。</p>
    <a>查看完整教程</a>
    <div class="ay-ct-c"><span class="ay-ct-n">普通对比 4.5:1</span><span class="ay-ct-n ok">AAA 7:1</span></div>
  </div>
</div>

原版代码的问题:想法的方向没问题,实现上有七个硬伤,其中第一个最容易被忽略。

① 三个按钮点了完全没反应

整段代码里没有任何 JS,.on 这个类是写死在第一个按钮上的。我实测了一下:

操作 结果
初始 .on 在第 1 个按钮
点第 2 个按钮 .on 还在第 1 个 ✗
点第 3 个按钮 依然没变 ✗

它是个静态示意图,不是能切换的开关。读者点了没反应,第一反应是"这文章的代码坏了"。

② 第三个按钮写着「深色高对比」,但代码里一条深色规则都没有

全文只有一处 prefers-contrast,没有任何深色配色。这个按钮承诺了一个不存在的功能。

③ 最要命的:在 Windows 高对比模式下,选中态彻底消失

这条是本段代码最讽刺的地方。我用 forced-colors: active(Windows 高对比主题触发的状态)实测三个按钮:

普通模式 强制高对比
选中按钮 蓝底 #5b7cfa + 白字 白底 + 黑字
未选中按钮 白底 + 灰字 #718096 白底 + 黑字
可区分吗 ✓ ✗ 只剩字重差别

原因是强制高对比会整体接管你的颜色:背景色被刷成系统底色,文字被刷成系统文字色。原设计靠"蓝底 vs 白底"区分选中,颜色一被接管,这个区分就没了。

④ <a> 没有 href

实测 Tab 聚焦失败——focus() 之后 activeElement 还是 BODY,键盘根本到不了。这已经是这批代码里第 N 次遇到无 href 的假链接了。

⑤ 四处对比度不达标

元素 配色 对比度
未选中的按钮 #718096 on 白 4.02 ✗
选中的按钮 白字 on #5b7cfa 3.68 ✗
链接 #5b7cfa on 白 3.68 ✗
标签 pill #718096 on #f7f9fc 3.81 ✗

标题 #2d3748(11.99)和正文 #4a5568(7.53)都很好,问题全在次要信息上——而这恰恰是高对比需求者最需要的部分。

⑥ 按钮没写 type:默认是 submit,放进表单里点一下会直接提交。

⑦ body{...} 会污染整站:老规矩,删掉。

修复版 · 对比度全达标 + 真正响应系统

HTML高对比度模式 · 修复版
<style>
.wxz-hc{max-width:520px;background:#fff;border:1px solid #cbd5e1;border-radius:14px;overflow:hidden;
  font:14px/1.7 system-ui,-apple-system,"PingFang SC","Microsoft YaHei",sans-serif}
.wxz-hc-hd{padding:9px 15px;background:#f1f5f9;border-bottom:1px solid #e2e8f0;
  font-size:12.5px;font-weight:700;color:#334155}
.wxz-hc-bd{padding:15px}
.wxz-hc-bd h3{margin:0 0 8px;font-size:15px;color:#0f172a}
.wxz-hc-bd p{margin:0 0 10px;font-size:13.5px;color:#334155}
.wxz-hc-bd a{color:#1d4ed8;font-size:13.5px;text-decoration:underline;text-underline-offset:2px}
.wxz-hc-c{display:flex;flex-wrap:wrap;gap:8px;margin-top:12px}
.wxz-hc-n{font-size:12px;background:#f1f5f9;color:#334155;padding:3px 10px;
  border-radius:20px;border:1px solid #e2e8f0}
.wxz-hc-n.ok{background:#f0fdf4;color:#166534;border-color:#bbf7d0}

/* 一、系统要求"更高对比度":这是信号,颜色仍由我们决定 */
@media (prefers-contrast:more){
  .wxz-hc{border-color:#0f172a;border-width:2px}
  .wxz-hc-bd h3,.wxz-hc-bd p{color:#000}
  .wxz-hc-bd a{color:#0000ee;text-decoration-thickness:2px}
  .wxz-hc-n{background:#fff;color:#000;border-color:#000}
}
/* 二、系统"强制接管颜色"(Windows 高对比主题):我们的配色会被整体覆盖,
   必须改用系统色关键字,否则背景、圆点这些全被刷成同一个颜色 */
@media (forced-colors:active){
  .wxz-hc{border-color:CanvasText}
  .wxz-hc-hd{background:Canvas;color:CanvasText;border-bottom-color:CanvasText}
  .wxz-hc-bd h3,.wxz-hc-bd p{color:CanvasText}
  .wxz-hc-bd a{color:LinkText}
  .wxz-hc-n{background:Canvas;color:CanvasText;border-color:CanvasText}
}
</style>
<div class="wxz-hc">
  <div class="wxz-hc-hd">当前模式:跟随系统设置</div>
  <div class="wxz-hc-bd">
    <h3>备案美化教程已更新</h3>
    <p>维形筑网的备案美化教程补上了 Typecho 版本。系统开启高对比后,这里的正文会自动加深到接近纯黑。</p>
    <a href="https://wxzcw.com/?s=%E5%A4%87%E6%A1%88">查看完整教程</a>
    <div class="wxz-hc-c"><span class="wxz-hc-n">普通 4.5:1</span><span class="wxz-hc-n ok">AAA 7:1</span></div>
  </div>
</div>

这版改了这些:

改动 作用 实测
去掉三个假按钮 不再有误导性的死控件 ✓
正文 #4a5568 → #334155 对比度提升 7.53 → 10.35 ✓
链接加 href + 下划线 可点击、可聚焦、不靠颜色区分 ✓
链接色 → #1d4ed8 对比度达标 3.68 → 6.70 ✓
标签 pill 字号 10px → 12px 中文不再发糊 —
补 @media (forced-colors:active) Windows 高对比下不塌 ✓
删掉 body{...} 不再污染全站 ✓

关键改动:补上 forced-colors 这一层

这是本段代码最该补的一课。两个媒体查询看着像,其实完全是两回事:

prefers-contrast: more forced-colors: active
本质 一个信号 系统接管
你的配色 照常生效,要自己加深 被整体覆盖
该怎么写 换成更深的颜色 改用系统色关键字
典型场景 macOS「增强对比度」 Windows 高对比主题

forced-colors 下要用的系统色关键字就那么几个:Canvas(背景)、CanvasText(正文)、LinkText(链接)、ButtonFace / ButtonText(按钮)。浏览器会按用户选的高对比主题把它们换成对应颜色。

也就是说:只写 prefers-contrast 不写 forced-colors,等于只适配了 macOS,Windows 用户那边还是塌的。

可切换版 · 三个按钮真能用(纯 CSS,不用 JS)

HTML高对比度模式 · 可切换版(纯 CSS)
<style>
.wxz-hc2{max-width:520px;background:#fff;border:1px solid #cbd5e1;border-radius:14px;overflow:hidden;
  font:14px/1.7 system-ui,-apple-system,"PingFang SC","Microsoft YaHei",sans-serif;position:relative}
/* 单选框只做视觉隐藏,不能用 display:none —— 那样键盘和读屏都到不了 */
.wxz-hc2 > input{position:absolute;width:1px;height:1px;opacity:0;margin:0}
.wxz-hc2-bar{display:flex;border-bottom:1px solid #e2e8f0;background:#f1f5f9}
.wxz-hc2-bar label{flex:1;text-align:center;padding:10px 4px;font-size:12.5px;font-weight:600;
  color:#334155;cursor:pointer;border-bottom:3px solid transparent}
.wxz-hc2-bd{padding:15px;background:#fff}
.wxz-hc2-bd h3{margin:0 0 8px;font-size:15px;color:#0f172a}
.wxz-hc2-bd p{margin:0 0 10px;font-size:13.5px;color:#334155}
.wxz-hc2-bd a{font-size:13.5px;color:#1d4ed8;text-decoration:underline;text-underline-offset:2px}

/* 档位二:高对比 */
#wxz-hc2-b:checked ~ .wxz-hc2-bd h3,
#wxz-hc2-b:checked ~ .wxz-hc2-bd p{color:#000}
#wxz-hc2-b:checked ~ .wxz-hc2-bd a{color:#0000ee;text-decoration-thickness:2px}
/* 档位三:深色高对比 */
#wxz-hc2-c:checked ~ .wxz-hc2-bd{background:#0b1220}
#wxz-hc2-c:checked ~ .wxz-hc2-bd h3{color:#fff}
#wxz-hc2-c:checked ~ .wxz-hc2-bd p{color:#f1f5f9}
#wxz-hc2-c:checked ~ .wxz-hc2-bd a{color:#7dd3fc}

/* 选中态靠"白底 + 实心下边框 + 下划线"三样,都不依赖颜色区分颜色 */
#wxz-hc2-a:checked ~ .wxz-hc2-bar label[for="wxz-hc2-a"],
#wxz-hc2-b:checked ~ .wxz-hc2-bar label[for="wxz-hc2-b"],
#wxz-hc2-c:checked ~ .wxz-hc2-bar label[for="wxz-hc2-c"]{
  background:#fff;color:#0f172a;border-bottom-color:#1d4ed8;text-decoration:underline}
/* 键盘聚焦要看得见 */
#wxz-hc2-a:focus-visible ~ .wxz-hc2-bar label[for="wxz-hc2-a"],
#wxz-hc2-b:focus-visible ~ .wxz-hc2-bar label[for="wxz-hc2-b"],
#wxz-hc2-c:focus-visible ~ .wxz-hc2-bar label[for="wxz-hc2-c"]{
  outline:2px solid #1d4ed8;outline-offset:-2px}
@media (forced-colors:active){
  .wxz-hc2{border-color:CanvasText}
  .wxz-hc2-bar{background:Canvas;border-bottom-color:CanvasText}
  .wxz-hc2-bar label{color:CanvasText}
}
</style>
<div class="wxz-hc2">
  <input type="radio" name="wxzmode" id="wxz-hc2-a" checked>
  <input type="radio" name="wxzmode" id="wxz-hc2-b">
  <input type="radio" name="wxzmode" id="wxz-hc2-c">
  <div class="wxz-hc2-bar">
    <label for="wxz-hc2-a">普通</label>
    <label for="wxz-hc2-b">高对比</label>
    <label for="wxz-hc2-c">深色高对比</label>
  </div>
  <div class="wxz-hc2-bd">
    <h3>备案美化教程已更新</h3>
    <p>维形筑网的备案美化教程补上了 Typecho 版本。切到高对比档,正文会加深到接近纯黑。</p>
    <a href="https://wxzcw.com/?s=%E5%A4%87%E6%A1%88">查看完整教程</a>
  </div>
</div>

想让原版那三个按钮真的能用,不需要写 JS——用单选框加 :checked 就够了。

结构是:三个 <input type="radio"> 放在最前面,后面的标签栏和内容区用 ~(后继兄弟选择器)去读它们的状态。

这么写有四个好处:

  • 不受 CSP 影响:内联 <script> 和 onclick 在加了安全策略的站点上会被整体拦截(我实测过:函数明明存在,点了毫无反应)。纯 CSS 方案没有这个问题。
  • 键盘原生可用:单选框组支持 Tab 进入、方向键切换,不用自己写。
  • 读屏原生可读:label 关联后会自动播报"普通/高对比/深色高对比"。
  • 不用维护状态:没有 JS 就没有状态同步的 bug。

两个细节要注意:

  • 单选框不能写 display:none,那样键盘和读屏都到不了。用 position:absolute + width:1px + opacity:0 做视觉隐藏。
  • 选中态不能只靠背景色。这版用了三样叠加:白底、实心下边框、下划线。实测在强制高对比下,背景和下边框被系统接管后,下划线依然在,选中态仍然分得出来。

整站适配版 · 一段能直接进主题的兜底

HTML高对比度模式 · 整站适配版
<style>
.wxz-hc4{max-width:520px;padding:16px;border-radius:14px;background:#fff;border:1px solid #cbd5e1;
  font:14px/1.7 system-ui,-apple-system,"PingFang SC","Microsoft YaHei",sans-serif}
.wxz-hc4 h3{margin:0 0 8px;font-size:15px;color:#0f172a}
.wxz-hc4 p{margin:0 0 12px;font-size:13.5px;color:#334155}
.wxz-hc4 a{color:#1d4ed8;text-decoration:underline;text-underline-offset:2px}
/* 关键技巧:平时是透明边框,看不出来;进入强制高对比后系统会自动把它填成实色 */
.wxz-hc4-btn{background:#1d4ed8;color:#fff;font:600 13px inherit;
  padding:8px 16px;border-radius:9px;border:2px solid transparent;cursor:pointer}
.wxz-hc4-btn.ghost{background:#fff;color:#1d4ed8}
.wxz-hc4-tag{display:inline-block;font-size:12px;padding:3px 9px;border-radius:999px;
  background:#fee2e2;color:#991b1b;border:1px solid transparent}
.wxz-hc4-card{margin-top:12px;padding:10px 12px;border-radius:10px;
  background:#f8fafc;border:1px solid #e2e8f0;color:#334155;font-size:13px}
@media (prefers-contrast:more){
  .wxz-hc4{border-color:#0f172a;border-width:2px}
  .wxz-hc4 h3,.wxz-hc4 p,.wxz-hc4-card{color:#000}
  .wxz-hc4 a{color:#0000ee}
  .wxz-hc4-btn{background:#fff;color:#000;border-color:#000}
  .wxz-hc4-tag{background:#fff;color:#000;border-color:#000}
  .wxz-hc4-card{border-color:#000}
}
@media (forced-colors:active){
  .wxz-hc4{background:Canvas;color:CanvasText;border-color:CanvasText}
  .wxz-hc4 h3,.wxz-hc4 p{color:CanvasText}
  .wxz-hc4 a{color:LinkText}
  .wxz-hc4-btn{background:ButtonFace;color:ButtonText}
  .wxz-hc4-card{background:Canvas;border-color:CanvasText}
}
</style>
<div class="wxz-hc4">
  <h3>滚动条美化教程</h3>
  <p>维形筑网的滚动条美化教程用的是纯 CSS 方案,不依赖任何 JS。</p>
  <a href="https://wxzcw.com/?s=%E6%BB%9A%E5%8A%A8%E6%9D%A1">查看教程</a>
  <div style="margin-top:12px;display:flex;gap:8px;align-items:center">
    <button class="wxz-hc4-btn" type="button">复制代码</button>
    <button class="wxz-hc4-btn ghost" type="button">收藏</button>
    <span class="wxz-hc4-tag">纯 CSS</span>
  </div>
  <div class="wxz-hc4-card">提示:改主题文件前建议先建子主题。</div>
</div>

这一块是给你整站用的,不只是这个卡片。核心是那个透明边框技巧,我做了对照实测:

按钮写法 普通模式边框 强制高对比下
border:0 无 边框宽度 0,按钮边界完全看不见 ✗
border:2px solid transparent 透明,看不出来 自动变成 2px 实色黑框 ✓

原理是:forced-colors 模式下浏览器会重写 border-color,但不会动 border-width。所以你预先留好一条透明边框,平时完全看不出来,用户一开高对比它就变成可见的轮廓。

同理,徽章、卡片、分割线这些靠底色区分的块,都建议预留一条透明边框。

另外这版把 prefers-contrast: more 的处理也写全了:正文转纯黑、链接换成系统蓝 #0000ee、边框加粗到 2px、按钮改成黑框白底。#0000ee 是浏览器默认的链接蓝,在高对比下依然是对比度最高的选择之一。

为什么类名都带 wxz- 前缀

CSS 是全局生效的,没有作用域。只要把 <style> 加进页面,里面的规则就作用于整个站点,而不只是你粘贴的那一块。

原版用的 .ay-ct、.ay-ct-b 这类短名,撞名概率不低。我做过一组对照:把没加前缀的 CSS 注入一个已有同类名的站点,原本 40px 的标题被改成 13px、红色文字被改成灰色。加上 wxz- 前缀后再测,污染为 0。

所以:

  • 照抄时保留 wxz- 前缀,别图省事改回短名字。
  • 想改类名的话,CSS 和 HTML 里的类名要一起改,只改一处会整个失效。
  • CSS 放进主题自定义样式区是全站加载的;只想单篇使用,就把 <style> 直接写在文章里。

改的时候注意这几点

  • prefers-contrast 和 forced-colors 要成对写:前者是信号,后者是接管,只写一个会漏掉一半用户。
  • 选中态别只靠背景色:加下划线、边框或字重,强制高对比下颜色会被刷掉。
  • 给按钮和徽章预留透明边框:border:2px solid transparent,高对比下自动变实色。
  • 链接必须有 href 且最好带下划线:只靠颜色区分链接,在色觉障碍和高对比下都会失效。
  • 次要信息最容易不达标:正文往往没问题,日期、标签、说明文字才是重灾区。
  • 不用 JS 就别硬写 JS:单选框方案更省事,还没有 CSP 风险。

怎么用

CSS 放进主题自定义样式区;HTML 写在文章里需要展示的位置。

这几块都是纯 CSS,不依赖任何 JS 和建站程序,WordPress、Typecho、Hexo、Hugo 都能直接用。

如果是给整站做适配(第四块的思路),把 .wxz-hc4 那层限定去掉,换成你自己站点的选择器,然后把两段 @media 整段搬过去即可。

兼容性

prefers-contrast:Chrome / Edge 96 起、Safari 15 起、Firefox 101 起,全球覆盖率约 92%。forced-colors 覆盖更广,约 94%。两者都有约 6~8% 的浏览器不支持——但不支持的表现是沿用普通样式,不会出错,所以可以放心写。

系统色关键字(Canvas、CanvasText、LinkText、ButtonFace)只在 forced-colors 模式下有意义,平时不会生效,写在里面不影响正常显示。


代码仅供学习交流,禁止商用。更多网站美化代码,前往 维形筑网 www.wxzcw.com。

作者:Flechazo

如若转载,请注明出处:维形筑网 https://wxzcw.com

赞 (0)
维形筑网美化代码 AI 适配教程指南:从复制到上线的全流程
上一篇 2026年10月30日 下午7:16
时间轴样式:站点更新记录的竖向时间线
下一篇 2026年10月30日 下午8:24

相关推荐

维 形 筑 网