使用CSS变量和JavaScript实现主题切换:在:root中定义默认颜色,创建.dark-theme类覆盖变量,通过JS切换类名并结合localStorage保存用户偏好,支持跟随系统主题,实现平滑切换效果。

想让网页支持暗色和亮色主题切换?用 HTML、CSS 变量配合少量 JavaScript 就能轻松实现。关键在于把颜色定义在 CSS 自定义属性中,再通过 JS 动态切换类名或根变量,完成主题变更。
使用 CSS 变量定义主题
在 :root 中定义默认主题的颜色变量,再为另一种主题(比如暗色)创建单独的类,覆盖原有变量。
:root {
--bg-color: #ffffff;
--text-color: #333333;
--accent-color: #007bff;
}
.dark-theme {
--bg-color: #1a1a1a;
--text-color: #f0f0f0;
--accent-color: #00d4ff;
}
这样所有用到这些变量的地方都会自动响应变化。例如:
body {
background-color: var(--bg-color);
color: var(--text-color);
transition: background-color 0.3s ease;
}
button {
background-color: var(--accent-color);
}
添加主题切换按钮
在页面中放一个按钮,用于触发主题切换。
立即学习“Java免费学习笔记(深入)”;
这个按钮不需传参或复杂结构,点击后由 JavaScript 控制逻辑。
用 JavaScript 切换主题
获取按钮并监听点击事件,切换 body 或 html 元素上的主题类名。
const toggleButton = document.getElementById('theme-toggle');
toggleButton.addEventListener('click', () => {
document.body.classList.toggle('dark-theme');
});
每次点击,dark-theme 类会被添加或移除,CSS 变量随之更新,界面自动重绘。
如果想记住用户偏好,可结合 localStorage:
// 页面加载时恢复上次选择
if (localStorage.getItem('theme') === 'dark') {
document.body.classList.add('dark-theme');
}
toggleButton.addEventListener('click', () => {
document.body.classList.toggle('dark-theme');
if (document.body.classList.contains('dark-theme')) {
localStorage.setItem('theme', 'dark');
} else {
localStorage.setItem('theme', 'light');
}
});
优化体验:默认跟随系统
首次访问时,可判断用户的系统偏好。
const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
if (localStorage.getItem('theme') === null) {
if (prefersDark) {
document.body.classList.add('dark-theme');
}
}
这样新用户打开页面会自动匹配系统主题,更贴心。
基本上就这些。HTML 提供结构,CSS 变量管理样式,JavaScript 控制交互,三者协作就能做出流畅的主题切换功能。不复杂但容易忽略细节,比如加过渡动画、保存状态、适配系统设置等,补上就完整了。











