必须在done回调中用事件委托绑定图片点击事件,因templet内联onclick会被转义失效,且each遍历无法应对翻页重载;需选对容器如.next('.layui-table-box'),并确保layer.photos传入结构为{photos:{data:[{src:'xxx'}]}}。
表格列中绑定图片点击事件必须在 done 回调里做
直接在 templet 里写 onclick 会失效,因为 layui 渲染时会对 html 字符串做转义,onclick 变成纯文本;用 each() 遍历绑定又扛不住翻页、重载。唯一可靠的方式是等表格渲染完成,在 done 回调中用 layui.$ 委托绑定事件。
注意目标容器要选对:#your-table-id 是表格外层占位 <div>,实际内容在它后面的 .layui-table-box 里,否则滚动后新行的图片点不了。
- 用
layui.$('#demo').next('.layui-table-box').on('click', '.view-img', ...)而不是document.querySelector - 给图片加一个统一 class(如
class="view-img"),不要依赖id或序号 - 避免绑定到
td上——容易和排序、复选框冲突
用 layer.photos 预览单图必须满足结构要求
layer.photos 不接受字符串或简单对象,传错就报 Cannot read property 'length' of undefined。它只认嵌套两层的结构:{photos: {data: [{src: 'xxx.jpg'}]}},且 data 必须是数组,src 字段名不能写成 url 或 image。
- 正确写法:
layer.photos({photos: {data: [{src: src}]}}) - 错误写法:
layer.photos({src: src})、layer.photos([src])、layer.photos({data: [...]}) - 如果图片地址为空、
null或about:blank,先加判断:if (!src || src === 'about:blank') return;
图片路径必须可访问,layer.photos 不校验 404
它拿到 src 就直接塞进 <img>,不会发起 HEAD 请求验证。URL 是相对路径(如 /upload/abc.jpg)还是绝对路径都行,但必须能被浏览器当前域名直接加载。跨域、权限拒绝、Nginx 未配 MIME 类型,都会导致预览空白,控制台却没明显报错。
- 调试时打开浏览器 Network 面板,过滤
Img,点开看是否返回 200 - 别用 base64 大图(尤其移动端),解码+渲染卡顿明显
- 服务端返回的图片 URL 最好带时间戳参数(如
?t=1745220720)防缓存旧图
固定列(fixed: 'left')下气泡位置偏移怎么办
如果用了 layer.photos,且表格有左固定列,你会发现弹出的相册遮罩位置歪了——这是因为它内部计算坐标时没考虑 .layui-table-fixed-l 的 transform 偏移。这不是 bug,是设计局限。
此时换用 layer.tips 更稳:它只生成轻量气泡,不走全屏遮罩逻辑,也不依赖复杂坐标推算。虽然不支持轮播,但单图预览够用,且 time: 0 + closeBtn: 1 能保证用户看清、能关掉。
layer.tips('<img src="' + src + '" style="max-width:200px;">', this, {time: 0, closeBtn: 1, tips: [1, '#fff']})- 别指望它悬停自动显示,必须绑定
click;也别让它跟随鼠标太近,否则手指点不到关闭按钮
layer.photos 能自动兜底 404 —— 它连请求都不发,只管塞 src。


















