要使Layui侧边栏每次加载时子菜单默认收起,需确保HTML结构初始无layui-nav-itemed类、子菜单不设内联显示,并在element.render('nav')后立即执行$('.layui-nav-item').removeClass('layui-nav-itemed')和$('.layui-nav-child').hide(),同时添加CSS .layui-nav-child { display: none !important; } 防御性隐藏。

Layui 侧边栏默认会保留上一次展开状态,若想让子菜单每次加载时都默认收起、只显示一级菜单,核心是清除 `.layui-nav-itemed` 类,并确保结构中不带该类初始化。
确保 HTML 结构初始无展开态
所有父级菜单项 `
- ` 必须放在 `
- 错误写法(会导致子菜单默认展开):
- 正确写法:
- ...
- 检查是否在 JS 中误调用了
element.tabChange()或element.render('nav')后又主动触发了展开逻辑
渲染后手动重置展开状态
在 element.render('nav', 'side') 执行完毕后,立即移除所有已存在的展开标记:
- 用 jQuery:
$('.layui-nav-item').removeClass('layui-nav-itemed'); - 同时隐藏所有子菜单:
$('.layui-nav-child').hide(); - 注意:这一步必须在
render()之后、页面就绪前完成,否则会被后续操作覆盖
配合 CSS 隐藏子菜单(防御性处理)
即使 DOM 状态清空,也建议加一层 CSS 保险,防止因 JS 延迟或异常导致子菜单意外显示:
- 在自定义 CSS 文件中添加:
.layui-nav-child { display: none !important; } - 若需支持手风琴效果(点击才展开),保留此规则,由 Layui 的
element.on('nav')自动控制显隐即可 - 避免使用
visibility: hidden,它仍占布局空间,影响点击区域
动态菜单场景下的处理
如果菜单数据是异步加载(如从接口获取),需在菜单 DOM 插入并完成 element.render() 后再执行状态重置:
- 不要在数据返回后立刻操作 DOM,等
layui.use(['element'], function(){})内部执行 - 可封装为函数:
resetNavState = () => { $('.layui-nav-item').removeClass('layui-nav-itemed'); $('.layui-nav-child').hide(); }; - 在
element.render('nav', 'side')回调里调用该函数











