讲师中心 微信公众号
AI工具推荐 视频效率加速

layui layer loading加载层 layui如何显示和关闭加载动画

秋浩同学_7910

秋浩同学_7910

发布时间:2026-03-16 19:15:11

|

551人浏览过

|

来源于php中文网

原创

layer.load() 返回数字索引,必须保存并在对应回调中调用 layer.close() 手动关闭;不可依赖 layer.closeAll('loading') 或 ajaxSetup 统一处理,应按需在 success/fail/done 等明确生命周期钩子中控制。

layer.load() 返回值必须保存,否则关不掉

很多人调用 layer.load() 后发现 loading 一直转,页面卡死——根本原因是没拿到返回值,后续没法调 layer.close()。layui 的 loading 层**不会自动关闭**,必须手动关,而且得关对那个实例。

  • layer.load() 返回的是一个数字索引(比如 12345),不是 DOM 节点,不能靠 class 或 id 去找
  • 如果在异步回调里想关,但变量作用域不对(比如定义在 if 里、没提升到外层),就会关错或报错 Cannot read property 'close' of undefined
  • 别用 layer.closeAll('loading') 图省事:它会干掉所有 loading,包括其他模块正在用的,容易引发竞态问题

正确做法是把索引存到外层变量或闭包里,确保 success/error 回调能访问到:

let loadingIndex;<br>$('#submitBtn').on('click', function() {<br>  loadingIndex = layer.load(1, { shade: [0.3, '#000'] });<br>  $.post('/api/save', data, function(res) {<br>    layer.close(loadingIndex);<br>    layer.msg('保存成功');<br>  }).fail(function() {<br>    layer.close(loadingIndex);<br>    layer.msg('保存失败');<br>  });<br>});

全局 AJAX 加载动画要慎用 $.ajaxSetup

用 $.ajaxSetup({ beforeSend: ... }) 统一加 loading 看似方便,但实际埋雷不少:它会影响所有 AJAX 请求,包括 layui 内部调用(如 table.render 的分页请求)、第三方插件、甚至浏览器扩展注入的请求。

  • 一旦某个请求没走 success/error(比如被拦截、超时未设 timeout、Promise 被 reject 但没 catch),loading 就永远挂着
  • $(document).ajaxStop() 不可靠:多个并发请求时,它可能在第一个请求结束就触发,导致 loading 提前关闭
  • 移动端弱网下,complete 钩子有时不执行,loading 残留概率更高

更稳的方式是「按需包裹」:只在你明确知道生命周期的业务请求里手动控制。比如表格加载用 done 回调关,表单提交用 success/fail 关,上传用 upload.on('done') 关。

自定义 loading 动画要注意 CSS 覆盖和路径问题

Layui 默认的 loading 是 SVG 动画,想换 GIF 或文字提示,得改两个地方:一是 layer 的 content 配置,二是图标样式。但直接改 .layui-layer-ico16 类容易失效,因为 layui 4.x 后部分版本用的是内联 base64 图标。

  • 推荐用 layer.load(1, { content: '处理中...' }) 配合 CSS 覆盖文字样式,比换图稳妥
  • 如果坚持用 GIF,路径必须相对于当前 HTML 页面,不是相对于 JS 文件;用相对路径时建议写成 ./img/loading.gif,避免被构建工具误处理
  • 别在 success 回调里用 layero.find() 改样式——这个钩子只在 layer 初始化时触发一次,数据回来再改无效

table 表格加载时的 loading 必须配 done 回调关

很多人以为给 table.render() 加了 loading: true 就万事大吉,其实这只是开启「翻页时的内置 loading」,首次渲染或重载(table.reload())并不会自动触发,得自己补。

  • 首次加载:必须在 render 前手动 layer.load(),并在 done 里关
  • reload 场景:table.reload() 不会触发 done,得监听 done 的第二个参数 res 是否为真实数据,或者用 where 变更触发重载时,在 before 钩子里开 loading(需自行维护状态)
  • 注意:done 是在数据返回后、表格 DOM 渲染完才执行,所以在这里关 loading 是安全的;若在 parseData 里关,表格还没画出来,用户会看到空白闪一下

复杂点在于异步操作嵌套多层时,loading 的开/关时机容易错位——比如先开 loading,再发请求,请求里又调另一个接口,结果外层关了,里层还在转。这种时候得用计数器或 Promise.all,而不是依赖单一索引。

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

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2123

2023.08.11

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

4543

2023.10.09

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

5690

2024.03.19

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

5118

2024.03.22

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

723

2024.05.22

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

80

2026.09.23

Buffalo框架路由与请求处理实操指南
Buffalo框架路由与请求处理实操指南

本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。

20

2026.09.23

Buffalo框架零基础入门教程
Buffalo框架零基础入门教程

本专题整理Buffalo框架入门内容,涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查,帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。

20

2026.09.23

Conan创建软件包配方指南
Conan创建软件包配方指南

本专题介绍通过conanfile.py创建软件包的方法,讲解包名、版本、依赖和构建设置等基础信息,以及source、build、package、package_info等常用方法的作用及编写思路。

20

2026.09.22

热门下载

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

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn