done回调里查不到tr,因为table.render()是异步的,DOM真实挂载在done触发后才完成;所有DOM查询必须放在done函数内,用this.elem或document.querySelector定位更稳妥。

done回调里查不到tr?必须等DOM真实挂载
table.render() 是异步的,调用完立刻执行 document.querySelector('.layui-table tbody tr') 一定为空。只有 done 触发时,.layui-table-body tbody tr 才真正插入文档流。别信“render 后 DOM 就好了”这种直觉——Layui 内部还要补 scrollbar、算固定列、插分页栏,这些都在 done 之后。
常见错误写法:
layui.table.render({ elem: '#demo', url: '/api/list' });
document.querySelectorAll('.layui-table tbody tr'); // ❌ 返回空 NodeList
正确姿势:所有 DOM 查询必须塞进 done 函数体内部。
- 用
document.querySelector('#demo')拿容器,再向下找table或tbody - 用
this.elem(指向配置的elem)比硬写选择器更稳,尤其页面有多个表时 - 不要依赖
tr[data-index]—— Layui 不自动写这个属性,res.data[i]才是当前页第 i 行的真实数据
直接改 innerHTML 会失效?因为Layui还会重绘
在 done 里执行 td.innerHTML = '已审核',页面可能一闪就变回原样。这不是你代码错了,而是 Layui 在 done 后还会跑 scrollbar 注入、列宽重算、甚至整个 tbody 替换逻辑 —— 你手动改的 DOM 被清掉了。
安全做法分三层:
- 静态内容优先用
templet列配置,比如状态码转文字:templet: d => d.status === 1 ? '启用' : '停用',它在每次排序/分页/搜索时都重执行,天然同步 - 真要动态加按钮或绑定 click,得用
setTimeout(() => {}, 0)延到 microtask 队列末尾,确保 Layui 渲染闭环结束 - 避免直接改
innerHTML,改innerText或加 class 更轻量,比如td.classList.add('status-success')
怎么精准定位到某列的 <th> 并改标题文字
<p>列标题是 <code><th> 元素,位于 <code>.layui-table-box .layui-table-header table th 下。done 里能安全操作,但要注意定位方式:
- 按字段名最准:
document.querySelector('th[data-field="status"]'),前提是初始化时 cols 里写了 field: 'status'
- 按索引次之:
document.querySelectorAll('th')[1](第二列),但列顺序一变就错
- 改完
innerText 后,如果后续要用 table.export 或列筛选,建议同步更新 layui.table.cache['your-table-id'].cols[0][1].title,否则导出还是旧标题
合并单元格为什么总失败?关键在清旧设新
document.querySelector('th[data-field="status"]'),前提是初始化时 cols 里写了 field: 'status'
document.querySelectorAll('th')[1](第二列),但列顺序一变就错innerText 后,如果后续要用 table.export 或列筛选,建议同步更新 layui.table.cache['your-table-id'].cols[0][1].title,否则导出还是旧标题合并本质是给 td 设 rowspan、隐藏重复 td。但 Layui 每次重载都会重建 tbody,如果你没在每次 done 开头清除旧的 rowspan 和 display: none,新旧属性叠加会导致错位或空白行。
实操要点:
- 先用
$("#demo").find(".layui-table-main table tbody td[rowspan]").removeAttr("rowspan")清旧 - 再用
res.data比对相邻行同列值是否相同,相同才设rowspan - 被合并的后续
td必须显式style.display = 'none',不能只靠rowspan推断 - 目标
table要准确定位:$("#demo").find(".layui-table-main table"),不是$("#demo")本身
合并逻辑必须包在每次 done 里,reload 或分页后不会自动复用——Layui 不维护合并状态。


















