You need to enable JavaScript to run this app. 深色模式刷新或切换页面后自动失效,如何通过JS实现主题状态持久保存
优惠活动
大模型
产品
解决方案
定价
更多

深色模式刷新或切换页面后自动失效,如何通过JS实现主题状态持久保存

状态丢失的核心原因

当前代码仅完成了点击时给文档根元素切换dark-mode类的操作,完全没有对用户的主题选择做持久化记录。一旦页面刷新或是跳转到其他子页面,浏览器会重新执行初始化流程,根元素回到无自定义类的默认状态,深色模式自然就失效了。

需要补充的核心逻辑
  • 主题切换时,把当前选中的主题状态同步写入浏览器的localStorage本地存储,不要仅修改DOM上的类名
  • 页面加载初始化时,先从本地存储读取用户之前保存的主题选择,在页面正式渲染前就给根元素加上对应类名,避免出现先显示亮色、再突然切深色的闪屏问题
  • 初始化时同步更新切换按钮的选中状态,防止实际主题和按钮勾选状态错位
基于现有代码的修改参考

不需要重写原有切换功能,直接在现有逻辑基础上补充本地存储的读写操作即可:

let button = document.querySelector('.onoffswitch-checkbox')

// 页面初始化时读取本地存储保存的深色模式状态
const savedDarkMode = localStorage.getItem('darkModeEnabled')
if (savedDarkMode === 'true') {
  document.documentElement.classList.add('dark-mode')
  // 同步把切换按钮设为勾选状态
  button.checked = true
}

button.addEventListener('click', ()=>{
  // 切换根元素的深色模式类,返回当前是否启用深色
  const isDarkOn = document.documentElement.classList.toggle('dark-mode')
  // 把当前状态存入本地存储,后续刷新、跳页都能读取到这个值
  localStorage.setItem('darkModeEnabled', isDarkOn)
})
实用优化提示
  • 上述读取本地状态的初始化代码,建议放在页面的<head>标签里内联执行,不要等整个DOM树加载完成再运行,能最大程度减少页面初次加载的亮色闪屏
  • 本地存储的键名(示例中用的darkModeEnabled)没有强制要求,只要保证全站所有页面统一用同一个键值存取即可

内容的提问来源于stack exchange,提问作者wissam baltaji

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.15 23:45:03