layui折叠面板支持多层嵌套,需在父面板展开后动态调用collapse.render()初始化子折叠,通过监听change事件、定位对应区域并标记已渲染来避免重复执行。

layui 的折叠面板(collapse)本身不原生支持多层嵌套自动初始化,但可以通过手动调用 layui.collapse.render() 分层初始化来实现“折叠内再嵌套折叠”,关键在于**子折叠必须在父面板展开后、且 DOM 已插入文档流时再渲染**。
确保子折叠 DOM 存在且可操作
嵌套的子折叠内容默认是隐藏的(比如放在 class="layui-colla-content" 内),只有当父级面板被点击展开时,其内容才真正进入可视/可操作状态。因此不能在页面加载时一次性渲染所有层级,否则子折叠因未挂载而失效。
- 把子折叠的 HTML 结构完整写在父面板的内容区中(无需额外 JS 创建)
- 子折叠容器需有唯一
id或可识别的选择器,方便后续单独渲染 - 避免在折叠内容里直接写
lay-filter="xxx"并期望自动生效——它不会被初始扫描到
监听父面板展开事件,动态渲染子折叠
利用 collapse.on('change', callback) 监听展开动作,在回调中判断是否为含子折叠的面板,然后对对应区域内的子折叠调用 render()。
- 给父折叠容器加
lay-filter="parentCollapse" - 在 JS 中监听 change 事件,通过
data.index或data.elem定位当前展开项 - 查找到该面板下的子折叠容器(如
$(data.elem).find('.child-collapse')),再执行layui.collapse.render('childCollapse')
示例结构与关键代码
HTML 示例:
<div class="layui-collapse" lay-filter="parentCollapse">
<div class="layui-colla-item">
<h2 class="layui-colla-title">一级菜单</h2>
<div class="layui-colla-content">
<!-- 这里放子折叠 -->
<div class="layui-collapse child-collapse" lay-filter="child1">
<div class="layui-colla-item">
<h2 class="layui-colla-title">二级菜单</h2>
<div class="layui-colla-content">内容...</div>
</div>
</div>
</div>
</div>
</div>JS 初始化:
layui.use(['collapse'], function(){
var collapse = layui.collapse;
<p>// 先渲染父级
collapse.render('parentCollapse');</p><p>// 监听展开,按需渲染子级
collapse.on('change(parentCollapse)', function(data){
var $content = $(data.elem).find('.layui-colla-content');
var $childCollapse = $content.find('.child-collapse');</p><pre class="brush:php;toolbar:false;">if ($childCollapse.length && !$childCollapse.data('rendered')) {
collapse.render($childCollapse.attr('lay-filter'));
$childCollapse.data('rendered', true); // 防止重复渲染
}
}); });
进阶:支持 N 层递归嵌套
若需三层及以上(如“一级 → 二级 → 三级”),可在子折叠的 change 事件中继续监听并渲染下一层,形成链式调用。核心原则不变:
- 每层折叠只负责渲染自己直系子层
- 用
data(elem)精准定位作用域,避免全局污染 - 用
data('rendered')或类名标记防止重复 render 导致事件绑定叠加











