Layui如何监听折叠面板（collapse）的展开事件

Layui折叠面板无expand事件，需用click监听.layui-colla-title并判断$content.is(':visible')或getComputedStyle高度；change回调仅限手风琴模式且不响应收起操作。

collapse.on('expand') 不起作用？先确认是否用了正确的事件名

如果你在代码里写了 collapse.on('expand', ...) 却发现没反应，这很正常——因为 Layui 的折叠面板（collapse）压根就没有 expand 这个内置事件。官方文档里也找不到它的踪影，你搜到的用法很可能是误传，或者跟其他 UI 库的 API 记混了。简单来说，Layui 本身并没有提供独立的“展开”或“收起”事件监听机制，想实现这个功能，得靠一些变通的方法。

实际上，可靠的入口只有两个：要么在 layui.use('collapse') 初始化后，用原生的 DOM 事件去监听点击行为；要么，就是利用那个有限制的 change 回调（注意，它只在手风琴模式下有效，并且需要是用户手动触发的）。

如何用 click 事件准确捕获展开动作

用户点击折叠面板的标题栏（.layui-colla-title）是触发状态变化的直接操作。但这里有个关键点：一次点击，既可能对应展开，也可能对应收起。所以，光监听点击还不够，必须准确判断点击后的实时状态。

• 核心思路是监听 .layui-colla-item 下的 .layui-colla-title 元素的 click 事件。
• 在回调函数里，通过 $(this).next('.layui-colla-content').is(':hidden') 来判断内容区域是否处于隐藏状态。如果返回 true，意味着即将展开；返回 false，则是即将收起。
• 要避免使用 $(this).parent().hasClass('layui-colla-item-active') 这类方法，因为 active 这个 class 是异步添加的，判断时机可能不准确。
• 如果你的面板启用了手风琴模式（accordion: true），要特别注意：当点击一个新项时，其他已展开的项会被自动收起。这时，状态判断最好放在 setTimeout(..., 0) 里，以确保能获取到 DOM 更新后的正确状态。

$('.layui-colla-title').on('click', function() {
  const $content = $(this).next('.layui-colla-content');
  setTimeout(() => {
    if ($content.is(':visible')) {
      console.log('已展开');
    } else {
      console.log('即将展开');
    }
  }, 0);
});

为什么不能直接监听 collapse.render 的回调

很多人会想到用 collapse.render() 的 change 参数，但它其实限制颇多。这个回调只在手风琴模式（accordion: true）下生效，而且触发条件很苛刻：必须是用户的点击操作导致了“当前激活项”发生切换。换句话说，如果你点击的是同一个标题（比如想把一个已经展开的面板收起来），change 回调根本不会执行。

• change 回调的参数是新激活项的索引（index），而不是一个简单的展开/收起布尔值，你无法直接从中区分动作类型。
• 在非手风琴模式（accordion: false）下，这个 change 回调是完全无效的。
• 另外，它只响应用户的点击行为。如果你通过 Ja vaScript 主动调用 collapse.update() 或者直接操作 DOM 来改变状态，change 同样不会被触发。

兼容性与性能提醒

方案选好了，细节也得抠。如果你的项目使用了 jQuery 3.6+ 版本，要注意 :hidden 这个伪选择器在某些复杂的嵌套布局或动态显示变化下，可能会有误判。更稳妥的方式，是直接读取计算后的样式：getComputedStyle($content[0]).height，判断其值是否为 '0px'。

• 从性能和维护角度考虑，不要在每一个 .layui-colla-title 元素上重复绑定 click 事件。更推荐使用事件委托：$(document).on('click', '.layui-colla-title', ...)，这样即使动态添加的面板也能被监听到。
• 值得注意的是，Layui 2.8+ 版本已经开始逐步弃用对 jQuery 的依赖。如果你的项目是纯原生引入（没有加载 jQuery），那么就需要改用原生 API，比如用 Element.classList.contains 检查类名，用 offsetHeight 来判断元素高度。
• 还有一个常见的坑：如果折叠面板的内容区域包含异步加载的数据或者复杂的 UI 组件，那么“展开完成”的实际时机，可能会晚于 DOM 变为可见的时机。因此，不要在 click 事件后立刻去操作内容区域里的子元素，否则可能找不到它们。

说到底，最麻烦的地方在于：Layui 没有向外暴露其折叠面板的内部状态机。我们所有的监听和判断，都只能围绕着 DOM 的当前状态来“打转”。一旦面板的 DOM 结构被第三方脚本修改，或者使用了自定义主题覆盖了默认的 class 名称，上面这些判断逻辑就可能失效，需要额外小心。