CSS变量配合Sass实现多主题切换:1. Sass中用map定义各主题色值并生成[data-theme]规则;2. CSS中统一使用var(--xxx)引用;3. JS控制data-theme属性切换并持久化;4. :root设默认值兜底。

用 CSS 变量(Custom Properties)配合预处理器(如 Sass/Less)实现多主题切换,核心思路是:把主题色、字体、间距等可变值抽离为 CSS 变量,在顶层(如 :root)定义默认值;再为不同主题(如 data-theme="dark")重写这些变量;预处理器负责结构化管理主题配置、生成对应类名和变量映射,提升可维护性。
1. 定义主题变量配置(预处理器层)
在 Sass 中,用 map 组织各主题的样式值,避免硬编码重复:
$themes: (
light: (
bg: #fff,
text: #333,
primary: #007bff,
border: #e0e0e0,
),
dark: (
bg: #121212,
text: #e0e0e0,
primary: #64b5f6,
border: #333,
),
blue: (
bg: #e3f2fd,
text: #1a237e,
primary: #1976d2,
border: #90caf9,
)
);
接着遍历 map,为每个主题生成对应的 [data-theme="xxx"] 规则块,并注入变量:
@each $theme-name, $theme-map in $themes {
[data-theme="#{$theme-name}"] {
--bg: map-get($theme-map, bg);
--text: map-get($theme-map, text);
--primary: map-get($theme-map, primary);
--border: map-get($theme-map, border);
}
}
编译后会输出类似:
立即学习“前端免费学习笔记(深入)”;
[data-theme="dark"] {
--bg: #121212;
--text: #e0e0e0;
--primary: #64b5f6;
--border: #333;
}
2. 在 CSS 中使用变量(运行时层)
所有组件样式直接引用 CSS 变量,不写死颜色或尺寸:
body {
background-color: var(--bg);
color: var(--text);
font-family: system-ui, sans-serif;
}
.btn {
background-color: var(--primary);
border: 1px solid var(--border);
color: var(--text);
}
.card {
background: var(--bg);
border: 1px solid var(--border);
}
这样,只要切换 document.documentElement.dataset.theme = 'dark',所有使用 var(--xxx) 的样式会自动响应更新。
3. 主题切换与持久化(JS 配合)
JavaScript 负责触发切换并保存用户偏好:
- 读取 localStorage 或 prefers-color-scheme 初始值
- 设置
document.documentElement.setAttribute('data-theme', 'dark') - 监听系统主题变化(
window.matchMedia('(prefers-color-scheme: dark)'))并同步 - 提供按钮调用
switchTheme('blue')并存入 localStorage
注意:CSS 变量支持继承和动态计算,比如 --text-inverted: color-mix(in srgb, var(--text) 50%, white);(现代浏览器),可进一步拓展主题表现力。
4. 预处理器增强技巧(可选)
提升开发体验的小技巧:
- 用 Sass 函数封装常用逻辑,如
theme-color('primary', 'dark')返回深色主题下的主色,用于构建非 CSS 变量场景(如内联 SVG fill) - 导出 JSON 主题配置,供 JS 运行时读取(如 i18n 或动态样式注入)
- 用
@use "sass:meta"实现主题校验,确保每个主题 map 包含必需 key
不复杂但容易忽略:确保 :root 中有默认变量值(防 JS 未加载或主题属性缺失),例如 :root { --bg: #fff; --text: #333; },作为降级兜底。










