table.render() 的 loading 文字不能直接动态更新,因其仅在初始化时读取配置且不响应式监听变化;需通过手动操作 dom(如定位 .layui-table-loading 元素并修改 text)来实现动态更新。

为什么 table.render() 的 loading 文字不能直接动态更新
Layui 的 table.render() 默认只在初始化时读取 loading: true 或 loading: {text: '加载中...'},之后不会响应式监听文字变化。你改了 JS 变量或 DOM 文本,表格内部的 loading 层(.layui-table-loading)并不会自动同步——它是一次性渲染的 DOM 片段。
用 table.set() 主动重置 loading 状态并更新文字
核心思路:不依赖初始化配置,而是手动控制 loading 层的显隐和文案。Layui 提供了 table.set() 配合 table.reload() 的组合方式来“欺骗”表格重新渲染 loading 区域。
- 先调用
table.set({defaultToolbar: []})(或其他无副作用配置)触发内部状态重置,但更稳妥的是直接操作 DOM - 实际更可靠的做法是:在发起异步请求前,手动显示 loading 层,并更新其文案;请求结束后再隐藏
-
table.cache和table.config不暴露 loading 元素引用,所以得靠 CSS 选择器定位:$('.layui-table[lay-id="yourId"] + .layui-table-box .layui-table-loading')
示例(假设表格 lay-id 为 userTable):
// 显示并更新 loading 文字
const $loading = $('.layui-table[lay-id="userTable"] + .layui-table-box .layui-table-loading');
if ($loading.length) {
$loading.find('div').text('正在校验权限...');
$loading.show();
}
// 模拟异步加载后
setTimeout(() => {
table.reload('userTable', {
url: '/api/users',
page: { curr: 1 }
});
$loading.hide(); // reload 后会自动 show 一次,所以这里 hide 是安全的
}, 800);
用 beforeSend 钩子(需 patch layui 源码或拦截 AJAX)
Layui 表格本身没有 beforeSend 回调,但它的数据请求走的是 layui.jquery.ajax。如果你用的是全局 $.ajaxSetup 或封装了 table.options.done 前的拦截点,可以在真正发请求前操作 loading 文案。
- 不推荐改 layui 源码,但可在
table.render()前临时覆盖layui.$.ajax,注入文案逻辑 - 更轻量的做法:在调用
table.reload()前,先手动设置一个全局 loading 状态变量,然后在done回调里清除——但这只能控制“开始”和“结束”,中间动态变化仍需 DOM 操作 - 注意:Layui 2.8+ 对
loading.text支持字符串函数(如loading: { text: () => statusText }),但该函数只在 loading 初始显示时执行一次,不持续轮询
容易被忽略的 DOM 时机和样式冲突
手动操作 .layui-table-loading 最常踩的坑不是逻辑,而是时机和 CSS 优先级:
- 表格未渲染完成时,
.layui-table-loading元素还不存在,$loading.length === 0—— 务必确保在table.render()执行后、或使用setTimeout(..., 0)延迟到下一轮事件循环再查 - 默认 loading 文字是居中灰色小号字体,如果页面有全局
font-size或color样式污染,可能让文字看不见或错位,建议加 inline style 强制重置:$loading.find('div').attr('style', 'font-size:12px;color:#999;') - 多个表格共用同一 lay-id 会导致 DOM 查找混乱,
lay-id必须唯一
动态 loading 的真实复杂点不在“怎么换文字”,而在于“什么时候能安全操作那个 div”——它生命周期短、无 API 暴露、且受表格重绘节奏影响。别试图让它“自动响应”,老老实实拿 jQuery 找、设、藏,最稳。











