Layui layer.photos 相册翻页需用 MutationObserver 监听 .layui-layer-phimg 的 data-index 变化,并结合防抖、keydown、touchend 和按钮委托实现全场景捕获,且须在关闭时显式销毁 observer 与事件监听以防内存泄漏。

需要在 Layui 的 layer.photos 相册预览中实时捕获用户翻页动作(如点击左右箭头、键盘方向键、触屏滑动),以便同步更新 UI 状态、埋点统计或联动其他组件。
监听 photos 翻页事件的核心原理
layer.photos 本身未暴露翻页事件钩子,但其内部通过修改 .layui-layer-photos .layui-layer-phimg 的 data-index 属性来标识当前图片序号,且每次翻页后会触发 layer.photos 的 success 回调——但该回调只在首次打开时执行一次,无法响应后续翻页。
真正可行的监听路径是:在 success 回调中启动一个 MutationObserver,专门监听 .layui-layer-photos 容器内 .layui-layer-phimg 元素的 data-index 属性变化。
用 MutationObserver 监听 data-index 变化
第一步:在 layer.photos 的 success 回调中获取相册弹层容器,并初始化观察器
第二步:监听 .layui-layer-phimg 元素的 attributes,过滤出 data-index 属性变更
第三步:当检测到 data-index 改变时,读取新值并执行业务逻辑——注意要防抖,避免连续触发(如快速连点箭头)
这一步操作起来很简单,直接把 observer 实例挂到 layero 上即可复用,避免重复创建。若不加防抖,用户快速翻页时可能触发数十次回调,导致 UI 卡顿或埋点重复上报。
兼容键盘与触屏翻页的补充监听
方法一:监听 document 的 keydown 事件(仅限弹层存在时)
在 success 回调里绑定:$(document).on('keydown.photos-listen', function(e) { if (e.key === 'ArrowLeft' || e.key === 'ArrowRight') { /* 触发翻页逻辑 */ } })
方法二:监听相册容器的 touchend(移动端滑动后判定方向)
需在 success 中记录 touchstartX,并在 touchend 时计算位移差,【必须判断位移绝对值 > 30px 才视为有效翻页手势】,否则轻微滑动就触发,体验极差。
方法三:监听 layer.photos 内部按钮点击(最稳定,但侵入性强)
给左右箭头添加事件委托:layero.on('click', '.layui-layer-photos .layui-layer-btnl, .layui-layer-photos .layui-layer-btnr', function() { /* 获取当前 data-index 并处理 */ })
完整可运行代码示例
第一步:调用 layer.photos 并传入 success 回调
第二步:在 success 中获取当前图片索引并初始化 observer
第三步:定义 handleIndexChange 函数,接收新 index 并执行业务(如更新底部页码显示、发送埋点)
第四步:使用 setTimeout + requestAnimationFrame 组合做轻量防抖,确保回调只在 DOM 稳定后执行一次
第五步:在 layer.close 或弹层销毁前,显式 disconnect observer 并解绑 document 事件——【否则关闭弹层后 observer 仍在后台运行,造成内存泄漏】











