Layui如何实现表格渲染前的Loading加载文字动态变化

千强吖_9496

千强吖_9496

2026-04-17

313人浏览

原创

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

layui如何实现表格渲染前的loading加载文字动态变化

为什么 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):

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

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

下载
// 显示并更新 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 找、设、藏,最稳。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

layui

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
ajax教程
ajax教程

php中文网为大家带来ajax教程合集,Ajax是一种用于创建快速动态网页的技术。通过在后台与服务器进行少量数据交换,Ajax可以使网页实现异步更新。这意味着可以在不重新加载整个网页的情况下,对网页的某部分进行更新。php中文网还为大家带来ajax的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.14

2820

4

ajax中文乱码解决方法
ajax中文乱码解决方法

ajax中文乱码解决方法有设置请求头部的字符编码、在服务器端设置响应头部的字符编码和使用encodeURIComponent对中文进行编码。本专题为大家提供ajax中文乱码相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.31

360

5

ajax传递中文乱码怎么办
ajax传递中文乱码怎么办

ajax传递中文乱码的解决办法:1、设置统一的编码方式;2、服务器端编码;3、客户端解码;4、设置HTTP响应头;5、使用JSON格式。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.15

2633

5

ajax网站有哪些
ajax网站有哪些

使用ajax的网站有谷歌、维基百科、脸书、纽约时报、亚马逊、stackoverflow、twitter、hacker news、shopify和basecamp等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.09.24

1161

6

Revel框架模板渲染与表单验证
Revel框架模板渲染与表单验证

本专题围绕Revel框架视图层开发,介绍模板语法、变量输出、布局复用、表单提交、参数绑定与验证规则,帮助开发者完成安全规范的页面交互。

2026.10.16

0

15

Revel框架MVC路由与控制器
Revel框架MVC路由与控制器

本专题聚焦Revel框架MVC核心机制,讲解路由定义、控制器Action、参数绑定、请求响应和反向路由,并结合常见场景梳理接口请求处理流程。

2026.10.16

0

15

Revel框架入门与安装配置
Revel框架入门与安装配置

本专题从Revel框架环境搭建讲起,系统介绍命令行工具安装、项目创建、目录结构、配置文件及热代码重载,帮助开发者快速完成首个Go Web应用。

2026.10.16

0

15

Linux 新手先学哪些命令
Linux 新手先学哪些命令

Linux新手命令专题汇集终端基础、文件目录操作、文本查看、软件安装和权限管理等入门文章,帮助按实际任务练习常用命令并建立命令行操作习惯。

2026.10.15

0

20

MySQL 忘记密码怎么办
MySQL 忘记密码怎么办

MySQL忘记密码专题汇集不同版本与系统下的root密码重置方法,覆盖MySQL 5.7、8.0、Mac、Linux及本地集成环境,并提示恢复权限与重新登录的检查步骤。

2026.10.15

0

18

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
ThinkPHP配置开发与CMS后台实战
ThinkPHP配置开发与CMS后台实战

共87课时 | 12.9万人学习

第二十三期_综合实战
第二十三期_综合实战

共89课时 | 11.1万人学习

Layui 快速入门精讲
Layui 快速入门精讲

共5课时 | 1.6万人学习