最稳的切换入口是 document.body.classList.toggle('dark'),它只增删语义明确的 dark class,不干扰现有类名,配合 :root 与 body.dark :root 双层 CSS 变量、DOMContentLoaded 时机读写 localStorage、ARIA 按钮及系统偏好监听,实现无闪屏、全组件响应的主题切换。

document.body.classList.toggle('dark') 是最稳的切换入口
导航栏作为页面高频可见区域,必须随主题实时响应。直接操作 document.body.classList.toggle('dark') 是唯一推荐方式——它不干扰现有 class(比如你用的 navbar、flex 或 Tailwind 类),只增删一个语义明确的 flag。别用 setAttribute('class', ...),那会清空所有已有 class;也别写 style.backgroundColor = '...',导航里 hover、focus、disabled 状态全得重写一遍。
常见错误是给导航容器单独加 nav.dark 规则,结果切换时漏了下拉菜单、图标、徽标等子元素。统一靠 body class 触发级联才是可持续方案。
- 确保导航 HTML 里没硬编码颜色,所有文本、背景、边框都用
var(--nav-bg)、var(--nav-text)这类 CSS 变量 - 切换按钮本身也要响应主题:图标颜色、背景、
aria-pressed状态都要同步更新 - 如果导航用了固定定位(
position: fixed),记得在body.dark .nav里补上transition: background-color 0.2s ease,否则闪动明显
:root + body.dark :root 双变量定义法避免样式污染
导航栏颜色不能只靠媒体查询自动适配,因为用户手动点按钮后,@media (prefers-color-scheme: dark) 无法覆盖用户主动选择。必须用两层 CSS 变量覆盖逻辑:
第一层在 :root 定义默认浅色值:--nav-bg: #fff、--nav-text: #333;第二层在 body.dark :root 里重写:--nav-bg: #121212、--nav-text: #e0e0e0。这样所有导航组件只需写一次 background: var(--nav-bg),无需重复声明暗色规则。
立即学习“前端免费学习笔记(深入)”;
- 别把变量写在
body.dark下(如body.dark { --nav-bg: ... }),那样变量作用域仅限于 body,子元素读不到 - 如果导航用了 SVG 图标,记得给
path加fill: var(--nav-text),否则图标不会随主题变色 - 第三方 UI 库(如 Bootstrap)若未适配 CSS 变量,需额外写
body.dark .navbar覆盖其原生 class 样式
localStorage 读写时机决定导航是否闪屏
导航栏首次渲染前就必须知道该用哪套颜色。等 window.onload 才读 localStorage.getItem('theme'),用户会看到 0.3 秒白底黑字的导航,再突变成暗色——这就是闪屏。正确时机是 DOMContentLoaded 阶段,且必须在任何样式表加载完成前执行。
代码顺序很关键:JS 脚本放在



















