Layui弹出层layer.msg如何设置显示时间

幻夢星雲

幻夢星雲

2026-08-03

324人浏览

原创

layui 2.8+ 中 layer.msg 的 time 默认为 0(永不关闭),必须显式设置如 time: 2000 才生效;旧版默认 3000,且小于 100 的值会被忽略,shade 需用数组格式 [0.3, '#000'] 才可靠。

layer.msg 的显示时间不是“设了就生效”,关键看版本和参数组合。layui 2.8+ 默认 time: 0(永不关闭),而旧版(如 2.5.x)默认是 3000;直接写 time: 2000 只有在显式传入时才起作用,不传反而挂住。

layer.msg 的 time 参数在不同版本中行为不一致

这不是你代码写错了,是文档没同步、版本没对齐导致的典型问题:

  • Layui ≤ 2.7.x:不传 time 时默认 3000(3 秒),time: 0time: -1 都表示常驻
  • Layui ≥ 2.8.0:不传 time 时默认 0(即永不关闭),必须显式写 time: 2000 才会 2 秒后关
  • 小于 100 的值(如 time: 50)会被底层忽略,最小有效阈值就是 100
  • 查当前版本:控制台执行 layui.version,别信“别人说的默认值”

设置 time 后遮罩(shade)失效或样式错乱

这是混用 shadetime 时最常踩的坑,尤其在 2.5.x ~ 2.7.x 版本中:

  • time 非零时,Layui 会跳过部分遮罩初始化逻辑,导致 shade: 0.3 不生效或背景变黑块
  • 正确写法必须用数组格式:{ shade: [0.3, '#000'] },单数字写法 shade: 0.3 在 combo 场景下大概率失效
  • 若仍异常,优先换 layer.open({ type: 1 }) 替代,它对 shade 支持更稳
  • 别依赖 shadeClose: true 单独工作——它只在 shade 存在且可点击时才响应,透明度低于 0.1 基本点不动

连续快速调用 layer.msg 导致闪退或覆盖

不是提示框“没显示”,而是上一个还没销毁,下一个就盖上去,视觉上像闪一下就没了:

layui手机车牌号码键盘代码
layui手机车牌号码键盘代码

layui手机车牌号码键盘代码是一款基于jQuery跟layui制作的手机端车牌号码输入弹出键盘选择,支持新能源汽车车牌输入格式代码。

下载
  • AJAX 成功回调里连写三次 layer.msg('ok'),极大概率只看到最后一次,前两个被吞掉
  • 解决方案不是加 setTimeout,而是用 tipsMore: true(仅限 layer.msg,非全局配置)
  • 更稳妥的做法:手动记录上一个索引,关掉再开:if (lastIndex) layer.close(lastIndex); lastIndex = layer.msg(...)
  • 图标加载异步,time: 500 会导致文字刚出、图标未渲染就关闭,带 icon 至少设 time: 1500

回调函数执行时机与 DOM 安全边界

layer.msg 的回调只在关闭“瞬间”触发,不等动画结束,也不保证 DOM 还在:

  • 回调里写 $('#form')[0].reset() 没问题,但写 $('#form').submit() 可能因页面已跳转而失败
  • 重定向前调用 layer.msg,提示框大概率被强制销毁,且不触发回调
  • 想区分关闭方式?Layui 不暴露关闭来源,只能自己接管:const index = layer.msg('...'); layer.close(index),这样你知道是脚本关的
  • 回调里避免同步耗时操作(如遍历万级数组),否则 UI 卡住,看起来像“没关成功”

真正麻烦的从来不是怎么写 time: 2000,而是当它和 shadeshadeClose、AJAX 回调、页面跳转搅在一起时,不同小版本的行为差异才会突然冒出来。上线前务必在目标环境实测两轮:一次快速连点,一次鼠标悬停+遮罩点击。

相关文章

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

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

下载

相关标签:

layui

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

相关专题

更多
ajax教程
ajax教程

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

2023.06.14

1094

4

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

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

2023.08.31

317

5

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

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

2023.11.15

993

5

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

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

2024.09.24

889

6

墨刀AI提示词教学
墨刀AI提示词教学

本合集由PHP中文网精心整理,为您提供全面的墨刀AI提示词教学。内容涵盖高质量原型撰写公式与实操窍门,助您轻松掌握AI设计工具。无论是零基础入门还是进阶技巧,都能让您快速上手,大幅提升产品设计与协作效率。

2026.08.04

6

21

墨刀AI完整入门
墨刀AI完整入门

PHP中文网为您倾力打造墨刀AI保姆级入门指南完整版!本合集从零基础讲起,涵盖AI生成原型、提示词优化、图片转原型及多轮对话等核心功能。无论您是新手还是进阶用户,都能轻松掌握产品设计全流程。快来PHP中文网,一键解锁高效设计技巧,让想法即刻成型!

2026.08.04

1

20

墨刀AI进阶技巧
墨刀AI进阶技巧

本合集由PHP中文网精心整理,为您提供墨刀AI核心进阶策略指南。内容涵盖高效提示词写作、原型智能生成与微调、结构化导图制作及行业分析报告输出等实战技巧。助您轻松掌握AI设计工具,大幅提升产品设计与团队协作效率。

2026.08.04

6

14

火山引擎实名认证失败怎么办
火山引擎实名认证失败怎么办

火山引擎实名认证失败可能与证件信息填写错误、姓名或企业信息不一致、证件照片不清晰、营业执照状态异常、手机号验证失败或审核资料不完整有关。本专题整理个人认证、企业认证、资料上传、审核退回、重新提交和认证不通过的常见处理方法。

2026.08.04

3

10

火山引擎域名备案流程详解
火山引擎域名备案流程详解

火山引擎域名备案适合需要在火山引擎云服务器、对象存储、CDN或网站服务上绑定域名的用户参考。本专题整理备案入口、账号实名认证、备案类型选择、主体信息填写、网站信息提交、资料上传、初审核验、管局审核和备案失败排查,帮助用户完成网站上线前的备案流程。

2026.08.04

0

10

热门下载

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

精品课程

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

共87课时 | 11.4万人学习

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

共89课时 | 9.7万人学习

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

共5课时 | 1.5万人学习