通过JavaScript结合CSS类、自定义属性和localStorage实现主题切换，支持深浅模式切换与系统偏好匹配，提升用户体验。
实现颜色主题切换功能在现代网页开发中非常常见，比如深色模式与浅色模式的切换。使用 JavaScript 可以轻松控制页面的主题颜色，提升用户体验。核心思路是通过 JS 动态修改页面的 CSS 样式或类名，从而实现主题切换。
1. 使用 CSS 类控制主题
最简单的方式是预定义几种主题样式类，然后通过 JavaScript 切换元素的 class。
例如，在 CSS 中定义两个主题：
body.light {
background-color: #fff;
color: #333;
}
body.dark {
background-color: #333;
color: #fff;
}
HTML 中设置一个按钮用于切换：
立即学习“Java免费学习笔记（深入）”；
JavaScript 监听按钮点击，切换类名：
document.getElementById('themeToggle').addEventListener('click', function() {
document.body.classList.toggle('light');
document.body.classList.toggle('dark');
});
首次加载时可检查用户偏好（如 localStorage）来设置默认主题。
2. 利用 CSS 自定义属性（变量）
CSS 变量让主题管理更灵活。可以在 :root 中定义变量，再通过 JS 修改。
:root {
--bg-color: #fff;
--text-color: #333;
}
.dark-theme {
--bg-color: #333;
--text-color: #fff;
}
body {
background-color: var(--bg-color);
color: var(--text-color);
transition: all 0.3s;
}
JS 只需切换类名即可：
document.getElementById('themeToggle').addEventListener('click', function() {
document.body.classList.toggle('dark-theme');
});
这种方式结构清晰，易于扩展多主题。
3. 持久化用户选择
为了记住用户的主题偏好，可以使用 localStorage。
页面加载时读取保存的主题：
// 页面加载时
if (localStorage.getItem('theme') === 'dark') {
document.body.classList.add('dark-theme');
} else {
document.body.classList.add('light'); // 或默认 light
}
// 切换时保存
document.getElementById('themeToggle').addEventListener('click', function() {
document.body.classList.toggle('dark-theme');
if (document.body.classList.contains('dark-theme')) {
localStorage.setItem('theme', 'dark');
} else {
localStorage.setItem('theme', 'light');
}
});
4. 结合系统偏好（ prefers-color-scheme ）
可以通过 matchMedia 检测用户系统的主题设置。
const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
if (localStorage.getItem('theme')) {
// 使用用户上次选择
} else if (prefersDark) {
document.body.classList.add('dark-theme');
} else {
document.body.classList.add('light');
}
这样既尊重系统设置，又允许用户自定义。
基本上就这些。通过类名切换 + CSS 变量 + localStorage，就能实现一个完整、流畅的主题切换功能。不复杂但容易忽略细节，比如初始状态处理和过渡动画。加上简单的 UI 提示，体验会更好。
