本文介绍如何利用 localstorage 在用户切换列表/网格视图后，自动保存并恢复当前视图状态，避免刷新丢失，适合前端初学者快速上手。
本文介绍如何利用 localstorage 在用户切换列表/网格视图后，自动保存并恢复当前视图状态，避免刷新丢失，适合前端初学者快速上手。
在构建具有视图切换功能的网页（如商品展示页的「列表模式」与「网格模式」）时，一个常见但关键的用户体验需求是：用户选择的视图状态应在页面刷新后依然保持。默认情况下，JavaScript 的状态仅存在于内存中，刷新即重置。解决这一问题最轻量、兼容性好且无需后端支持的方案，就是使用浏览器原生的 localStorage API。
✅ 核心思路三步走
- 读取：页面加载时，从 localStorage 中尝试获取上次保存的视图类名（如 "list" 或 "grid"）；
- 应用：若读取值有效且不同于元素当前 class，则立即更新 DOM；
- 保存：每次用户点击切换时，将新 class 写入 localStorage，确保状态实时持久化。
✅ 完整可运行代码（优化版）
// 获取 DOM 元素
const toggleBtn = document.getElementById('x');
const viewContainer = document.getElementById('z');
// 1. 页面加载时尝试恢复视图状态
const savedClass = localStorage.getItem('viewMode');
if (savedClass && ['list', 'grid'].includes(savedClass)) {
viewContainer.className = savedClass;
}
// 2. 绑定切换事件
toggleBtn.addEventListener('click', function() {
const currentClass = viewContainer.className;
// 切换逻辑：list ↔ grid
const newClass = currentClass === 'list' ? 'grid' : 'list';
viewContainer.className = newClass;
// 3. 持久化新状态
localStorage.setItem('viewMode', newClass);
});⚠️ 注意事项与最佳实践
- 健壮性校验：使用 ['list', 'grid'].includes(savedClass) 替代简单相等判断，防止因意外值（如 null、空字符串或拼写错误）导致样式异常；
-
初始 class 必须明确：确保 HTML 中 的初始 class 是 'list' 或 'grid' 之一（如），否则首次加载可能无法正确识别；
- 存储键名语义化：推荐使用 viewMode 等清晰键名，而非泛用的 "class"，便于后期维护和扩展（例如增加排序、筛选等其他状态）；
- 兼容性无忧：localStorage 支持所有现代浏览器及 IE10+，无需 polyfill；
- 清除测试：开发调试时，可在浏览器控制台执行 localStorage.removeItem('viewMode') 或 localStorage.clear() 快速重置状态。
? 扩展建议（进阶）
- 若需支持多用户或多设备同步，可将状态存至后端（如通过 API + 用户 session）；
- 结合 CSS 自定义属性（CSS Variables）实现更灵活的主题/布局控制；
- 添加视觉反馈（如按钮图标切换、过渡动画），提升交互体验。
通过以上实现，你不仅解决了视图状态持久化的实际问题，也掌握了 localStorage 这一前端基础存储工具的核心用法——简单、可靠、即学即用。
