Layui collapse 无原生 expand/collapse 事件,正确方式为监听 .layui-colla-title 点击并判断内容区可见性;change 回调仅限手风琴模式且不响应收起操作。

Layui 的 element 模块本身不提供原生的 expand 或 collapse 事件,官方文档中也无 collapse.on('expand') 这类写法——这是常见误区。真实可用的方式只有两种:手动监听点击 + 状态判断,或在手风琴模式下利用 change 回调(但仅响应展开,不响应收起)。
✅ 正确监听展开/收起动作:用 click + 可见性判断
折叠面板的标题 .layui-colla-title 是用户唯一可点击区域。监听它,再判断紧邻内容区是否将要显示:
layui.use('jquery', function(){
var $ = layui.jquery;
$(document).on('click', '.layui-colla-title', function(){
var $content = $(this).next('.layui-colla-content');
var isCurrentlyHidden = $content.is(':hidden');
// 延迟执行,确保 DOM 状态已更新(尤其 accordion 模式下)
setTimeout(function(){
if ($content.is(':visible')) {
console.log('已展开');
} else {
console.log('已收起');
}
}, 0);
});
});- 用
$(document).on()是推荐做法,避免重复绑定、兼容动态插入的面板 - 判断
:visible/:hidden简单直接,但若页面用了 jQuery 3.6+ 且存在嵌套 display 变化,更稳妥的是读取计算样式:var height = window.getComputedStyle($content[0]).height; var willExpand = height === '0px';
⚠️ change 回调只适用于手风琴模式,且有严重限制
layui.use(['element'], function(){
var element = layui.element;
// 必须开启 accordion: true 才会触发 change
element.render('collapse', null, {
accordion: true
});
// change 仅在「切换到新项」时触发,点已展开项收起 → 不触发!
element.on('collapse(test)', function(data){
console.log('当前激活项索引:', data.index); // 仅返回数字,不是布尔值
});
});- ❌ 非手风琴模式(
accordion: false)下change完全无效 - ❌ 同一项点击两次(展开→收起)不会触发
change - ❌ JS 调用
element.collapse.update()或操作 DOM 不会触发
? 补充:如何主动控制展开/收起状态
Layui collapse 不提供 open(index) 或 toggle(index) 方法。如需程序控制,只能:
- 手动添加/移除
.layui-colla-item-active类 - 同步控制
.layui-colla-content的display或height - 触发一次
element.render('collapse')强制重绘(慎用,会重置所有状态)
例如展开第 0 项:
var $item = $('.layui-colla-item').eq(0);
$item.addClass('layui-colla-item-active');
$item.find('.layui-colla-content').show();注意:这绕过了内部状态管理,后续用户点击可能行为异常,建议仅用于初始化默认状态。
不复杂但容易忽略。


















