侧边栏折叠状态本地缓存通过“状态读取→响应式绑定→变更同步→持久写入”四步闭环实现:useSidebarCollapse 封装 localStorage 操作,返回响应式 isCollapsed 和 toggle/open/close 方法,自动同步并支持刷新保持。

侧边栏折叠状态的本地缓存,核心是“状态读取 → 响应式绑定 → 变更同步 → 持久写入”四步闭环。Vue 3 组合式函数中不依赖 Vuex 或 Pinia 全局状态管理也能干净实现,关键是把 localStorage 操作封装为可复用、可响应的逻辑。
定义带响应式的缓存状态
用 ref 包裹初始值,并在初始化时从 localStorage 读取:
- 创建一个组合式函数,例如 useSidebarCollapse;
- 内部调用 getSidebarStatus()(来自 utils/localStorage.ts)获取上次保存的状态;
- 将结果转为布尔值:比如 'opened' → true,'closed' → false;
- 用 ref 创建响应式变量 isCollapsed,初始值即该布尔值。
监听变更并自动写入 localStorage
使用 watch 监听 isCollapsed 的变化,触发持久化:
- watch 回调中调用 setSidebarStatus(isCollapsed.value ? 'closed' : 'opened');
- 注意状态语义:el-menu 的 :collapse 接收 true 表示折叠,所以 isCollapsed = true 对应 “已折叠”,对应存储值应为 'closed';
- 避免在 setup 中直接操作 window.localStorage —— 封装进工具函数里更利于测试和 SSR 兼容。
暴露控制方法供组件调用
组合式函数返回可操作的 API:
- toggle():反转 isCollapsed 值;
- open() 和 close():显式设为展开/折叠;
- isCollapsed:响应式 ref,直接传给 el-menu 的 :collapse 属性。
在菜单组件中使用
在 AppSidebar.vue 或 BasicMenu.vue 中:
- 解构 isCollapsed 和 toggle;
- 将 :collapse="isCollapsed" 绑定到
; - 折叠按钮(如顶部 toggle bar)绑定 @click="toggle";
- 无需手动处理刷新后状态丢失——初始化时已从 localStorage 拉取。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










