暗黑模式切换必须依赖CSS自定义属性,Less仅作编译时变量管理;需用Mixin生成:root与[data-theme="dark"]下的--color-bg等变量,组件样式统一使用var(--x),JS通过setAttribute切换data-theme并持久化状态。

暗黑模式切换必须依赖 CSS 自定义属性(CSS Custom Properties)
Less 本身是编译时预处理语言,无法在运行时动态切换主题。所谓“优雅实现”,本质是用 Less 管理变量 + 输出适配现代浏览器的 :root 自定义属性体系,再配合 JS 切换 data-theme="dark" 类名触发样式重算。
直接在 Less 中写两套 @color-bg: #fff; @color-bg: #121212; 是无效的——Less 编译后只保留一个值。必须把主题变量“提升”到 CSS 运行时层面。
- 所有主题色、间距、阴影等应定义为
--color-bg、--spacing-md等自定义属性,写在:root和[data-theme="dark"]选择器下 - Less 只负责生成这两套属性声明,不参与逻辑判断
- 避免用
@media (prefers-color-scheme: dark)做兜底——它不可控、不可编程,且无法响应用户手动切换
用 Less Mixin 封装主题变量声明,避免重复手写 :root 块
手动维护两组 :root { --x: y; } 和 [data-theme="dark"] { --x: z; } 极易出错。用 Less Mixin 抽象共性,让深色/浅色变量成对注入:
.theme-vars(@light, @dark) {
:root { .make-vars(@light); }
[data-theme="dark"] { .make-vars(@dark); }
}
.make-vars(@map) {
.loop(@map) when (length(@map) > 0) {
@key: extract(extract(@map, 1), 1);
@val: extract(extract(@map, 1), 2);
--@{key}: @val;
.loop(extract(@map, 2+));
}
.loop(@map);
}
// 使用
.theme-vars(
((bg, #ffffff), (text, #333333), (border, #e0e0e0)),
((bg, #121212), (text, #e0e0e0), (border, #333333))
);
这样既保持 Less 的可维护性,又输出干净的 CSS 自定义属性。注意:Mixins 不支持嵌套 map 遍历,所以传入的是扁平二维 list。
立即学习“前端免费学习笔记(深入)”;
组件样式中禁止直接引用 Less 变量,一律使用 var(--x)
这是最容易踩的坑:开发者习惯性写 background: @color-bg;,结果切换主题完全无效。所有组件级样式必须基于运行时变量:
- 按钮背景:
background: var(--color-bg);,不是@color-bg - 文字颜色:
color: var(--color-text);,并确保该变量在:root和[data-theme="dark"]中均已定义 - 慎用
var(--color-bg, #fff)回退值——它只在变量未定义时生效,不能替代主题声明 - 渐变、阴影等复合值需拆解为独立变量,如
--shadow-sm、--gradient-primary,避免在box-shadow里拼接var(--color-shadow) 0 1px 3px导致语法错误
JS 切换 data-theme 时需同步 localStorage 并监听系统偏好变化
Less 编译完就结束了,后续一切靠 JS 驱动。关键点不在 Less,而在初始化逻辑是否健壮:
- 页面加载时优先读取
localStorage.getItem('theme'),其次 fallback 到matchMedia('(prefers-color-scheme: dark)').matches - 设置
document.documentElement.setAttribute('data-theme', 'dark'),不要改 body 或其他节点 - 监听系统偏好变更:
window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', ...),但仅当用户未手动切换过主题时才响应 - 避免在 SSR 场景下 JS 执行前出现“闪屏”——服务端可依据请求头或 cookie 注入初始
data-theme
暗黑模式的复杂性不在样式编写,而在于状态同步的时机和边界条件。比如用户先开暗黑系统,再手动切回亮色,此时必须锁定用户选择,不再随系统自动变。


















