通过CSS变量、媒体查询和JavaScript可实现网页主题切换。首先定义亮色与暗色模式的颜色变量，并应用于页面样式；利用prefers-color-scheme媒体查询自动适配系统偏好；通过JavaScript控制data-theme属性实现手动切换，并将用户选择存入localStorage；结合transition实现平滑过渡，提升视觉体验。完整流程包括初始化主题、按钮交互、状态记忆与界面反馈，确保功能流畅且用户友好。
现在很多网站都支持主题切换，尤其是暗色模式的适配，不仅能提升用户体验，还能保护用户视力。实现 HTML 在线网页的主题切换和暗色模式适配并不复杂，关键是合理使用 CSS 变量、媒体查询和 JavaScript 动态控制。
使用 CSS 自定义变量统一管理主题颜色
通过 CSS 自定义变量（CSS Variables），可以集中管理亮色和暗色主题的颜色值，便于切换。
:root {
--bg-color: #ffffff;
--text-color: #333333;
--primary-color: #007bff;
}
[data-theme="dark"] {
--bg-color: #1a1a1a;
--text-color: #f0f0f0;
--primary-color: #00d4ff;
}
将这些变量应用到页面元素：
body {
background-color: var(--bg-color);
color: var(--text-color);
transition: background-color 0.3s ease, color 0.3s ease;
}
button.primary {
background-color: var(--primary-color);
}
利用 prefers-color-scheme 实现自动暗色模式
借助 prefers-color-scheme 媒体查询，可以让网页根据系统设置自动适配暗色模式。
立即学习“前端免费学习笔记（深入）”；
@media (prefers-color-scheme: dark) {
html {
/* 默认加载暗色主题 */
background-color: #1a1a1a;
color: #f0f0f0;
}
}
结合 data-theme 使用更灵活：
@media (prefers-color-scheme: dark) {
html:not([data-theme="light"]) {
background-color: var(--bg-color);
color: var(--text-color);
}
}
JavaScript 实现手动主题切换按钮
添加一个按钮，允许用户手动切换主题。
用 JavaScript 控制切换逻辑：
const toggleBtn = document.getElementById('theme-toggle');
const currentTheme = localStorage.getItem('theme') || 'auto';
// 初始化主题
if (currentTheme === 'dark') {
document.documentElement.setAttribute('data-theme', 'dark');
} else if (currentTheme === 'light') {
document.documentElement.setAttribute('data-theme', 'light');
}
toggleBtn.addEventListener('click', () => {
const current = document.documentElement.getAttribute('data-theme');
let newTheme;
if (current === 'dark') {
newTheme = 'light';
} else if (current === 'light') {
newTheme = 'auto'; // 回到系统偏好
} else {
newTheme = 'dark'; // auto 状态下点击切换为暗色
}
if (newTheme === 'auto') {
document.documentElement.removeAttribute('data-theme');
} else {
document.documentElement.setAttribute('data-theme', newTheme);
}
localStorage.setItem('theme', newTheme);
});
优化细节：平滑过渡与状态记忆
为了提升体验，建议加入颜色过渡动画，并将用户选择存储在 localStorage 中，避免刷新后重置。
- CSS 中添加 transition 属性，让背景和文字颜色变化更自然
- 页面加载时读取 localStorage，恢复上次选择的主题
- 可增加图标或文字提示当前主题状态（如“?”或“☀️”）
基本上就这些。合理组合 CSS 变量、媒体查询和 JavaScript，就能实现一个流畅、智能又可自定义的网页主题切换功能。不复杂但容易忽略细节，比如过渡效果和本地存储，加了之后体验会好很多。
