done回调是数据加载完毕的唯一可靠信号，它在HTTP响应成功、res校验合法、分页参数计算完成且tbody插入DOM后触发，但不保证视觉样式就绪或DOM完全渲染。

done回调就是数据加载完毕的唯一可靠信号

layui表格没有“渲染完成”或“DOM就绪”的独立钩子，done是框架明确提供的、**唯一能确认原始响应数据已接收、解析并准备就绪**的时机。它不保证所有视觉样式或滚动条补丁已注入，但足以确认 res 可用、分页参数（curr, count）已生效、当前页数据已进入内存。

为什么不能用 table.render() 返回值或 setTimeout 判断

table.render() 本身是同步调用，返回的是配置对象，不是 Promise，也不阻塞后续代码；直接在它后面写 document.querySelector('.layui-table tbody tr') 大概率查不到——因为 DOM 插入是异步的，且可能被后续 scroll 补丁覆盖。

• 用 setTimeout(() => {}, 0) 或 Promise.resolve().then() 无法替代 done：它们只等 JS 执行队列清空，不感知 layui 内部的数据绑定与分页逻辑
• 监听 table.on('pull', 'filter') 或 table.on('sort', 'filter') 是事件响应，不是加载状态判断依据
• 检查 layui.table.cache['id'] 是否存在？不可靠——cache 在 done 前就可能被预设，但数据未必来自本次请求

done 回调触发的准确条件

done 在以下全部满足时触发：

• HTTP 请求成功返回（或本地 data 已传入）
• res 被校验为合法对象（含 data 数组和可选的 count）
• 当前页码 curr 和总条数 count 已计算完成（即使后端没返回 count，Layui 也会按 res.data.length 估算）
• 表格主体 已插入 DOM，且每行 的 data-index 属性已写入（注意：这个属性仅用于内部定位，不建议依赖）

  只要配置了 url 或 data，done 就一定会执行一次；开启分页后，每次翻页、搜索、重载也都会再次触发。

  

  深蓝色网站后台管理系统layui框架模板-AdminPro

  一款深蓝色网站后台管理系统layui框架模板

  下载

  容易误判的典型场景

  常见错误是把“数据加载完毕”和“用户可见内容稳定”混为一谈：

  • 虚拟滚动开启（limit > 100）时，done 中遍历 document.querySelectorAll('tbody tr') 只拿到可视区域行，但 res.data 是整页数据——别用 DOM 数量反推是否加载完
  • 用了 response 配置自定义字段名（如 statusName: 'code'），但 done 的 res 仍是原始响应体，未经过 response 映射——校验逻辑要基于原始结构写
  • 表格容器本身被动态 display: none 隐藏，done 仍会触发，但后续 DOM 操作（如 getBoundingClientRect()）可能返回 0 —— 此时需额外监听容器可见性

  真正需要“DOM 完全就绪”的操作（比如精确测量行高、绑定原生事件），得在 done 内再套一层 setTimeout(() => {}, 0)，让浏览器有机会完成 layout。