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

广告容器必须用 data-theme 而非 class 控制主题
很多页面把广告塞进 正确做法是让广告容器直接响应 广告图常含文字或 logo,直接套用浅色模式下的 PNG 或 SVG,在深色背景下会不可读。常见错误是给图片加 推荐方案分三类: Google AdSense、Media.net 等 SDK 渲染的广告 iframe 内容,完全不受父页 能做的有限但关键: 很多人以为加了 真正可控的是你写的文案容器,不是广告 iframe 里的内容。所以: 最易被忽略的一点:广告区域的 .ad-banner.dark 切换样式——这会导致两个问题:一是和第三方广告 SDK 的 class 冲突(比如 Google AdSense 自带 google-ad-sizer),二是无法继承 级别的 color-scheme,原生控件(如广告里的 )在深色模式下仍显示浅色背景。html[data-theme="dark"] 选择器:
html[data-theme="dark"] .ad-slot { background-color: var(--ad-bg); },变量统一由 :root 定义style="background:#f9f9f9" 这类硬编码必须删掉,否则 JS 切换主题时完全不生效广告图片/图标需适配深色背景对比度
filter: brightness(0.8)——OLED 屏上发灰,且破坏色彩准确性。
fill="currentColor",并确保父容器文本色已通过 var(--ad-text) 正确声明 + 切换,避免 JS 加载延迟导致闪白color 和 background-color,悬停态单独定义 --ad-bg-hover,不能依赖 opacity第三方广告脚本会绕过 prefers-color-scheme
@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
就万事大吉,结果广告文案在深色模式下变成浅灰字配深灰背景,对比度仅 2.1:1,远低于 WCAG 4.5:1 要求。
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 阴影模拟凹陷感。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











