layui左侧菜单收缩展开需状态切换、CSS过渡、DOM同步三者配合;推荐用admin.sideFlexible()(需2.8+及admin模块),或手动toggle layui-side-collapsed类并同步主体left值,禁用直接改width或display:none。

layui 后台模板实现左侧菜单栏收缩与展开切换,核心是「状态切换 + CSS 过渡 + DOM 同步」三者配合,不能只改宽度或只切 class。官方 admin 模块提供了便捷方法,但必须按规范调用;手动实现则更可控、兼容性更好。
用 admin.sideFlexible 方法(推荐,需 layui 2.8+ + admin 模块)
这是最简洁、状态管理最完整的方式,但有前提条件:
- 必须使用 Layui 官方 admin 模板结构,并已正确引入
admin.js - 必须在
layui.use(['admin'], function(){...})回调内调用,不可在全局或 DOM 加载完成时直接执行 - 无参数调用可切换当前状态:
admin.sideFlexible() - 传
0强制收起,传1强制展开:admin.sideFlexible(0)
手动切换 class 实现(通用、稳定、推荐备用方案)
不依赖 admin 模块,适合定制化强或低版本场景。关键在 CSS 类定义和 JS 状态同步:
- 给侧边栏容器加过渡:
.layui-side { transition: width .3s ease; } - 定义收缩类:
.layui-side-collapsed { width: 60px; overflow: hidden; } - 收缩时图标居中、文字隐藏:
.layui-side-collapsed .layui-nav-item a { justify-content: center; text-align: center; padding-left: 0; }<br>.layui-side-collapsed .layui-nav-item span { display: none; }<br>.layui-side-collapsed .layui-nav-child { display: none !important; } - JS 中仅做两件事:
$('.layui-side').toggleClass('layui-side-collapsed')和同步主体偏移:$('.layui-body, .layui-footer').css('left', isCollapsed ? '60px' : '200px')
模拟点击折叠按钮(最稳妥的触发方式)
避免自己维护状态逻辑,复用模板原有事件处理(含 cookie 记录、响应式适配等):
- 为顶部折叠按钮设置唯一 ID,如
id="LAY_app_flexible" - 触发点击:
document.getElementById('LAY_app_flexible').click() - 若无 ID,可用选择器:
document.querySelector('.layadmin-layout-left .layadmin-flexible').click()
必须避开的常见错误
这些做法会导致菜单错位、子菜单失效、图标不同步或点击区域丢失:
- 直接用
.animate({width: '60px'})或修改行内style.width—— 绕过 layui 状态跟踪 - 用
display: none隐藏整个侧边栏 —— 悬停/点击全部失效 - 在
element.on('nav')回调里操作宽度或 toggle 子菜单 —— 破坏layui-nav-itemed等状态类 - 在
element.render('nav')之前或之后未同步 class 状态 —— 渲染会清空你手动加的collapsed











