广告容器必须用 data-theme 控制主题:禁用 class 切换和内联 style,通过 html[data-theme="dark"] 选择器统一管理样式;广告图片/图标需适配深色背景对比度;第三方广告 iframe 需加遮罩并设置 color-scheme: light;手写文案须用明确亮度的 CSS 变量确保 WCAG 对比度达标。

广告容器必须用 data-theme 而非 class 控制主题
很多页面把广告塞进 <div class="ad-banner">,然后靠 <code>.ad-banner.dark 切换样式——这会导致两个问题:一是和第三方广告 SDK 的 class 冲突(比如 Google AdSense 自带 google-ad-sizer),二是无法继承 级别的 color-scheme,原生控件(如广告里的 <input type="text">)在深色模式下仍显示浅色背景。
正确做法是让广告容器直接响应 html[data-theme="dark"] 选择器:
- 广告外层容器不加 class,只保留语义结构,例如
<aside class="ad-slot" aria-label="广告"></aside> - CSS 中写
html[data-theme="dark"] .ad-slot { background-color: var(--ad-bg); },变量统一由 :root 定义 - 禁用内联 style:
style="background:#f9f9f9"这类硬编码必须删掉,否则 JS 切换主题时完全不生效
广告图片/图标需适配深色背景对比度
广告图常含文字或 logo,直接套用浅色模式下的 PNG 或 SVG,在深色背景下会不可读。常见错误是给图片加 filter: brightness(0.8)——OLED 屏上发灰,且破坏色彩准确性。
推荐方案分三类:
立即学习“前端免费学习笔记(深入)”;
- SVG 广告图标:设
fill="currentColor",并确保父容器文本色已通过var(--ad-text)正确声明 - PNG/JPEG 广告图:提供两套资源,用
<picture></picture>+<source media="(prefers-color-scheme: dark)"></source>切换,避免 JS 加载延迟导致闪白 - 文字型广告(如赞助商横幅):用 CSS 变量控制
color和background-color,悬停态单独定义--ad-bg-hover,不能依赖 opacity
第三方广告脚本会绕过 prefers-color-scheme
Google AdSense、Media.net 等 SDK 渲染的广告 iframe 内容,完全不受父页 @media (prefers-color-scheme: dark) 影响。用户看到的是广告平台自己定的主题,常与你的深色模式不匹配(比如深色页面里弹出亮白广告框)。
能做的有限但关键:
- 用
html[data-theme="dark"] iframe给广告 iframe 加一层半透明遮罩(background: rgba(0,0,0,0.04)),缓解对比刺眼 - 广告容器设置
color-scheme: light(CSS 属性),强制其内部原生控件(如广告里的按钮)保持浅色,避免深色背景+深色文字的双重失效 - 监听
window.matchMedia('(prefers-color-scheme: dark)')变更后,调用广告 SDK 的刷新接口(如adsbygoogle.push({})),部分平台支持重载
广告文案颜色不能只靠系统 fallback
很多人以为加了 <meta name="color-scheme" content="light dark"> 就万事大吉,结果广告文案在深色模式下变成浅灰字配深灰背景,对比度仅 2.1:1,远低于 WCAG 4.5:1 要求。
真正可控的是你写的文案容器,不是广告 iframe 里的内容。所以:
- 所有手写的广告标题、副标、CTA 按钮,必须用
color: var(--ad-text),且该变量在深色模式下明确设为#e0e0e0或更亮值 - 避免用
hsl(0,0%,60%)这类相对值——它在深色模式下可能还是灰,得用 LCH 或 Lab 坐标校验亮度 - 禁用
transparent作背景色:广告容器若设background: transparent,深色模式下会透出的深背景,再叠一层广告图就糊成一片
最易被忽略的一点:广告区域的 border-color 和 box-shadow 必须也是 CSS 变量,且深色模式下 shadow 不能用 rgba(0,0,0,0.3) —— 在 #121212 背景上几乎看不见,得调成 rgba(0,0,0,0.08) 或换用 inset 阴影模拟凹陷感。



















