table.reload()传data不刷新是因url未清空；toolbar事件需在done回调重绑；树表异步加载中reload会导致请求中断；scrollPos:'fixed'无效需手动存取滚动位置。
table.reload() 传了 data 却没刷新，是因为 url 没清空
这是最常被忽略的硬性规则：只要你在 table.render() 里配过 url，后续用 table.reload() 传 data 时，url 必须显式设为空字符串或 null，否则 layui 会优先走异步请求，直接忽略你传的 data。
常见错误写法：
table.reload('myTable', { data: newData }); // ❌ 不生效，url 还在缓存里
正确写法：
table.reload('myTable', {
data: newData,
url: '' // ✅ 强制清空 url
});
-
url: ''和url: null效果一致，选其一即可 - 如果表格原本就没配
url（纯前端数据），那这一步可跳过 - 这个行为在 Layui 2.8+ 中依然存在，不是 bug，是设计逻辑
reload 后 toolbar 按钮点击失效，是事件绑定被销毁了
table.reload() 会重新渲染整个表格 DOM，包括 toolbar 区域。如果你的 toolbar 按钮事件是在 layui.use 块内、通过 table.on('toolbar(...)', ...) 绑定的，那 reload 后这些监听器就丢了——因为旧 DOM 被删了，新 DOM 上没重新绑定。
解决方式只有一种：把 toolbar 事件定义包进 done 回调里，确保每次 reload 都重装一次：
table.render({
elem: '#myTable',
url: '/api/list',
done: function(res, curr, count){
// ✅ 这里重绑 toolbar 事件，reload 后也会执行
table.on('toolbar(myTable)', function(obj){
if(obj.event === 'add'){
// 处理新增逻辑
}
});
}
});
- 别把事件写在
layui.use外层静态位置，那样只初始化一次 - 如果用了自定义
toolbar模板（如toolbar: '#toolbarTpl'），也要确保模板 HTML 在 reload 前已存在且未被移除
异步加载中调用 reload，子节点数据可能被中断或丢失
当树形表格（treeTable）处于 async.enable: true 状态时，正在展开某个节点、请求子数据的过程中，如果触发 table.reload() 或 treeTable.reloadData()，Layui 不会等待异步请求完成，而是直接清空当前加载状态，导致：
- 正在进行的请求被浏览器 abort（Network 面板显示 canceled）
- 已加载但尚未渲染的子节点数据丢失
- 节点图标状态错乱（比如显示“展开中”但实际没数据）
稳妥做法是加个轻量级锁：
let isAsyncLoading = false;
treeTable.on('expand(myTreeTable)', function(obj){
if(isAsyncLoading) return; // 阻止并发展开
isAsyncLoading = true;
// 展开后，在 done 回调里重置
obj.tr.data('node').done = function(){
isAsyncLoading = false;
};
});
- 不要依赖
obj.node.LAY_ASYNC_STATUS做判断，它不可靠 - 真正安全的 reload 时机，是等所有节点都处于稳定状态（无 loading 图标、无 pending 请求）
scrollPos: 'fixed' 不生效，得手动存取滚动位置
table.reloadData() 的 scrollPos: 'fixed' 参数在多数场景下根本不起作用——源码里它只对极简结构生效，一旦表格有固定列、复杂模板或高度动态内容，滚动位置就会重置到顶部。
绕过方案：自己动手记位置、手动滚回去：
const $tableContainer = $('#myTable').next('.layui-table-box');
const scrollTop = $tableContainer.scrollTop();
table.reloadData('myTable', {
where: { keyword: 'xxx' }
}, function(){ // done 回调
$tableContainer.scrollTop(scrollTop);
});
- 必须用
.next('.layui-table-box')找容器，而不是直接操作#myTable - 注意：如果表格高度在 reload 后变化（比如行数变少），
scrollTop可能超出范围，需做Math.min(scrollTop, maxScroll)保护 - 这个细节在文档里几乎不提，但线上真实项目里 90% 的滚动复位问题都出在这儿
