
通过 localstorage 存储用户暗色模式偏好,并在页面加载时自动应用,可实现跨页面、跨会话的暗色模式状态保持。
通过 localstorage 存储用户暗色模式偏好,并在页面加载时自动应用,可实现跨页面、跨会话的暗色模式状态保持。
要在多页面之间持续记住用户的暗色模式选择,关键在于:将用户操作(开启/关闭)同步写入浏览器的 localStorage,并在每个页面加载时读取并应用该状态。原代码仅在当前页面切换 class,未做持久化与初始化处理。
以下是完整、健壮的实现方案:
✅ 步骤一:统一管理暗色模式开关
将 onclick="darkmode()" 改为更语义化的 toggleDarkMode(),并完善逻辑:
<img onclick="toggleDarkMode()" id="darktoggledesktop" src="media/darktoggle.svg" alt="切换暗色模式">
✅ 步骤二:增强 JavaScript 逻辑(含存储与初始化)
<script>
// 切换暗色模式并持久化保存
function toggleDarkMode() {
const body = document.body;
body.classList.toggle("dark-mode");
// 同步更新 localStorage
const isDark = body.classList.contains("dark-mode");
localStorage.setItem("darkMode", isDark ? "enabled" : "disabled");
}
// 页面加载时恢复用户偏好
function loadDarkModePreference() {
const saved = localStorage.getItem("darkMode");
if (saved === "enabled") {
document.body.classList.add("dark-mode");
}
}
// 确保 DOM 加载完成后再执行初始化(比 window.onload 更可靠)
if (document.readyState === "loading") {
document.addEventListener("DOMContentLoaded", loadDarkModePreference);
} else {
loadDarkModePreference();
}
</script>
? 提示:使用
DOMContentLoaded替代window.onload可避免等待图片、样式表等资源加载,提升响应速度。
✅ 步骤三:CSS 保持简洁有效(无需修改)
确保你的 CSS 已正确定义 .dark-mode 的全局样式(如背景、文字、过渡),例如:
.dark-mode {
background-color: #121212;
color: #e0e0e0;
transition: background-color 0.4s, color 0.4s;
}
/* 可选:为表单控件、链接等补充暗色适配 */
.dark-mode a { color: #bb8fca; }
.dark-mode input, .dark-mode button { background: #333; border-color: #555; }
⚠️ 注意事项
-
隐私模式兼容性:部分浏览器在无痕窗口中会禁用
localStorage,建议添加 try-catch 包裹写入逻辑; -
服务端渲染(SSR)场景:若使用 Next.js/Nuxt 等框架,需在客户端生命周期中执行
loadDarkModePreference,避免服务端报错; -
系统级暗色偏好兜底(进阶):可通过
window.matchMedia('(prefers-color-scheme: dark)')检测系统设置,并作为首次访问的默认值。
通过以上改造,用户无论刷新页面、跳转到站内其他 URL,甚至关闭浏览器后重新打开,暗色模式都将按其上次选择自动启用——真正实现“一次设置,处处生效”。










