Pinia 通过 layout store 统一管理侧边栏折叠状态,state 中定义 isCollapse 布尔值并支持 localStorage 持久化,各组件响应式读取和调用 toggleCollapse/setCollapse 修改,实现跨组件同步控制。

Pinia State 处理侧边栏折叠与展开,核心是把 是否折叠 这个布尔值作为共享状态统一管理,并在多个组件(如侧边栏、头部按钮、菜单容器)中响应式读取和修改它。
定义折叠状态的 Store
在 src/stores/layout.ts(或类似路径)中创建一个独立 store:
- 使用
defineStore声明一个名为layout的 store -
state中定义isCollapse: boolean,初始值一般为false - 可选:加入
localStorage持久化逻辑,在初始化时读取,避免刷新丢失
示例代码:
export const useLayoutStore = defineStore('layout', {
state: () => ({
isCollapse: localStorage.getItem('sidebar-collapse') === 'true' || false,
}),
actions: {
toggleCollapse() {
this.isCollapse = !this.isCollapse;
localStorage.setItem('sidebar-collapse', this.isCollapse.toString());
},
setCollapse(value: boolean) {
this.isCollapse = value;
localStorage.setItem('sidebar-collapse', value.toString());
}
}
});
在侧边栏组件中绑定 collapse 属性
Element Plus 的 <el-menu></el-menu> 或自定义菜单组件支持 :collapse Prop。直接从 store 解构出 isCollapse 即可:
- 用
storeToRefs获取响应式isCollapse,确保视图自动更新 - 将
:collapse="isCollapse"绑定到菜单组件上 - 宽度也可动态控制,例如
:width="isCollapse ? '64px' : '200px'"(配合<el-aside></el-aside>)
在头部按钮组件中触发状态切换
顶部操作栏中的折叠按钮,只需调用 store 的 action 即可:
- 在
setup中引入useLayoutStore - 调用
store.toggleCollapse()或store.setCollapse(!store.isCollapse) - 无需 emit、props 或事件总线,跨组件通信干净直接
补充:支持响应式适配与默认行为
实际项目中常需兼顾不同设备:
- 可在
onMounted中监听window.resize,当屏幕宽度小于某阈值(如 768px)时自动设为折叠 - 折叠状态下隐藏文字、只留图标,可用
v-show="!isCollapse"控制标题或菜单项文本 - 若需服务端权限控制菜单结构,
isCollapse状态仍保持独立,不影响路由/菜单数据加载逻辑


















