深色模式刷新或切换页面后自动失效,如何通过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
相关产品推荐
相关产品推荐

