layer.photos 是 Layui 内置的相册式图片预览组件，适用于展示一组逻辑关联的多图（如商品图集），需传入含 src 字段的 data 数组或指定图片容器，支持左右切换、全屏、缩略图导航和键盘控制。

layer.photos 是什么，什么时候该用它layer.photos 是 Layui 内置的相册式图片预览组件，不是通用弹窗，也不是简单 layer.open 套个 <img> 就完事。它自带左右切换、全屏、缩略图导航、键盘控制（←→ESC）等能力，适合展示一组有逻辑关联的图片（比如商品图集、用户上传的多张证件照）。

• 用它，前提是图片数据结构明确：必须是包含 data 数组的 JSON 对象，每项含 src 和可选的 alt
• 不适合单张图临时预览——那种场景直接 layer.open({ type: 1, content: '<img src=...>' }) 更轻量
• 它不自动处理图片尺寸适配，也不响应鼠标滚轮缩放，这些得自己加

两种初始化方式：JSON 数据 vs 页面 DOM 扫描 Layui 支持两种入口，但行为和限制完全不同：

• json 模式（推荐）：传入完整数据对象，可控性强

  layer.photos({ photos: { title: '我的相册', data: [{ src: '/a.jpg', alt: '第一张' }] } });

  ✅ 可动态构造数据，适配异步加载（如点击按钮后 $.get 拿到数据再调用） ❌ 必须保证 data 是数组，且每项至少有 src 字段；空数组或字段缺失会静默失败

• DOM 扫描模式：指定一个容器，Layui 自动找里面所有 <img>

  layer.photos({ photos: '#gallery' });

  ✅ 快速上手，适合静态 HTML 图片列表 ❌ 无法自定义每张图的 alt 或额外元信息；若容器内有非图片元素（比如 <div>），可能报错或跳过

常见失败原因：success 回调没执行、图片点不开、缩略图不显示 这不是 bug，而是配置或时机问题：

• success 回调不触发？说明 layer.photos() 根本没成功打开——检查传入的 photos 是否为合法对象/选择器是否存在/控制台是否有 Uncaught TypeError: Cannot read property 'length' of undefined
• 图片点击无反应？确认你没在图片上绑了 event.preventDefault()，或者父级元素用了 pointer-events: none
• 缩略图空白或错位？Layui 默认只读取 src，如果想显示缩略图，必须显式提供 thumb 字段，否则它会把原图拉小渲染，模糊且卡顿
• 动态加载后调用无效？别在 AJAX 回调里直接写 layer.photos(...)，先确保 DOM 已更新，必要时加 setTimeout(..., 0) 或用 MutationObserver 监听节点插入

想加缩放/旋转？别改源码，用 success 注入事件 Layui 不开放内部图片 DOM 的操作接口，但 success 回调给了你精准的“手术窗口”：

• 缩放必须监听 wheel（不是 mousewheel，后者已废弃），并用 event.preventDefault() 阻止页面滚动
• 计算缩放中心点要用 getBoundingClientRect() + clientX/clientY，不能直接用 offsetLeft/Top（因为预览层是绝对定位）
• 旋转按钮建议用 tab 回调插入，而不是硬塞进 success，避免重复添加
• 所有样式修改（如 transform: scale() rotate()）必须作用在 #layui-layer-photos img 上，而不是外层容器，否则会连带缩略图一起变

真正麻烦的从来不是写几行代码，而是每次 Layui 升级后，.layui-layer-photos 里的 class 名或 DOM 层级微调，都可能让你的缩放逻辑突然失效。所以关键不是“怎么实现”，而是“怎么让它活得久一点”——把核心计算逻辑抽成独立函数，用 document.querySelector 加容错判断，比死磕固定选择器靠谱得多。