layer.photos传参必须为{photos: {data: [{src: 'url'}]}}结构，不可传字符串或单对象；图片需可访问完整URL；表格中须用事件委托绑定，且img标签必须含data-src属性。
layer.photos 传参结构必须是 {photos: {data: [...]}}，不是字符串或单对象
很多人调用 layer.photos 时直接传 layer.photos({src: 'xxx.jpg'}) 或 layer.photos('/path.jpg')，结果控制台报 cannot read property 'length' of undefined。这是因为 layer.photos 只接受两层嵌套结构：photos 字段下必须是对象，且该对象内必须有 data 数组，数组每一项是带 src 字段的对象。
- ✅ 正确写法：
layer.photos({photos: {data: [{src: 'https://example.com/1.jpg'}]}}) - ❌ 错误写法：
layer.photos({src: '1.jpg'})、layer.photos(['1.jpg'])、layer.photos({data: [...]})（缺外层photos） -
src是唯一必需字段；alt、pid可选但建议填，尤其多图时pid必须唯一，否则翻页错乱 - 如果后端返回的是相对路径（如
uploads/a.png），确保它相对于当前页面可解析；推荐统一返回完整 URL
表格中图片点击事件必须委托绑定，不能写在 templet 里
在 layui.table 的 cols 中用 templet 渲染 <img> 时，别写 onclick="layer.photos(...)" —— 渲染后会被转义成纯文本，且翻页、重载后事件丢失。
- ✅ 推荐做法：给
<img>加统一 class（如class="table-img-preview"），在table.render()的done回调里委托绑定：layui.$('#your-table').next('.layui-table-box').on('click', '.table-img-preview', function() {...}) - ⚠️ 容器必须选对：
.layui-table-box才是实际滚动区域，#your-table只是占位 div，绑错就点不了新加载的行 - 别用原生
document.querySelector或each()遍历绑定——动态内容无法覆盖 - 移动端需额外监听
touchstart，避免点击延迟
data-src 不是可选字段，而是 layer.photos 读取大图的唯一依据
layer.photos 不会主动请求图片，它只从 DOM 已渲染的 <img> 元素上读取 data-src 属性值。哪怕只有一个 data-src 为空、404 或跨域，整个相册都可能静默降级为“没有照片”。
- ✅ templet 中必须返回含
data-src的<img>，例如：<img src="{{d.thumb}}" alt="{{d.alt}}"> 可以是缩略图， data-src必须是可访问的大图地址（带协议或能被浏览器正确解析的相对路径）- 用开发者工具检查目标
<img>元素，确认data-src存在且值非空；若后端返回的是登录态保护资源，需确认当前请求携带 cookie 或 token - 同一行多个图片组成一个相册？别指望 layer 自动扫描——得手动拼 JSON 数组塞进
data-photos='{"data":[...]}'容器属性里
缩放和旋转要接管 .layui-layer-phimg，不能用 transform: scale()
Layui 原生不支持自定义缩放比例，强行给 .layui-layer-phimg 加 transform: scale(1.5) 会导致切换图片时失效、旋转错位、弹层偏移——因为 layer 内部会重置该元素所有 style 属性。
- ✅ 正确方式：监听
.layui-layer-phimg，读取img.naturalWidth/naturalHeight，按比例计算目标宽高，再设置其width/height和父容器left/top实现居中缩放 - 必须显式加
max-width: none，否则 CSS 限制会干扰 - 滚轮缩放易误触，业务中更推荐按钮或快捷键（如
Ctrl+1→ 100%，Ctrl+2→ 200%） - 旋转功能同理：改
.layui-layer-phimg父级的transform: rotate()，并同步调整left/top防止溢出
data-src 地址是否真实可访问、photos 结构是否严格嵌套、事件委托是否绑对了滚动容器——这三个点没对齐，其他再精细的缩放逻辑也出不来。 
