done回调必须写在table.render()配置内,因其执行时表格dom已就绪;参数res为完整响应体,curr为当前页码,count为总条数;this指向table实例,可调用this.reload()等方法。

done 回调必须写在 table.render() 配置里,不能放外面
表格 DOM 是异步插入的,table.render() 调用完立刻返回,但 .layui-table tbody tr 还没生成。如果你把 document.querySelector('.layui-table tbody tr') 写在 render() 后面,一定为空。
正确做法是把所有依赖表格 DOM 的逻辑(比如查找行、绑定额外事件、修改样式)全塞进 done 函数里:
-
done执行时,.layui-table-box tbody tr已真实挂载,可安全使用原生或 jQuery 查询 - 别加
setTimeout(() => {}, 0)——done已是 DOM 就绪后的最早时机 -
done不会在请求失败、超时、解析出错时触发,异常要靠error或全局$.ajaxSetup捕获
done 函数的三个参数:res、curr、count
done 接收三个参数:res 是服务器返回的完整响应体(不是 res.data),curr 是当前页码,count 是总条数。注意后端结构若不符合 Layui 默认约定(比如没包在 data 字段下),必须配合 parseData 函数转换,否则 res 里拿不到正确数据。
常见错误写法:
done: function(res, curr, count) {
console.log(res.data); // ❌ 很可能 undefined,因为 res 就是整个响应体
}
正确写法(假设后端返回 {code: 0, data: [...], count: 100}):
done: function(res, curr, count) {
console.log('共', count, '条'); // ✅ 安全
console.log('第', curr, '页'); // ✅ 安全
console.log(res.data); // ✅ 此时 res.data 才存在(前提是 parseData 没动结构)
}
done 里 this 指向 table 实例,能直接操作表格
done 函数内部的 this 是当前 table 实例对象,不是 window。它有多个实用属性:
-
this.elem:指向初始化时传入的elem对应 DOM(如#demo) -
this.elem.next():常用来获取渲染后的包裹容器(含.layui-table-box) -
this.reload():可在done里触发重载(比如根据条件自动刷新)
注意:tableIns.reload() 不能在 done 里直接用,因为 tableIns 是 render() 的返回值,而 done 执行时变量可能还没赋值。
不要在 done 里重新调用 table.render()
有人想“先空 render → 等 done → 再 fetch 数据 → 再 render”,这是高危操作。Layui 会尝试重绘整个容器,导致 ID 冲突、工具栏按钮重复、分页器错位,控制台常报 Uncaught Error: Table instance not found 或 Cannot read property 'config' of undefined。
正确路径只有一条:先请求数据(或确定列结构)→ 构建 cols 和 data → 一次性调用 table.render()。如果列字段不确定,就提前用 AJAX 拿一条样本,提取 Object.keys(data[0]) 动态生成 cols,再 render。
动态列本身没问题,但 field 值必须合法(不能含点号、空格),否则排序、搜索、导出全部静默失效 —— 这个细节最容易被忽略。











