Layui弹出层layer.open如何设置在点击遮罩层时执行特定函数

秋磊小哥_6728

秋磊小哥_6728

2026-06-07

413人浏览

原创

layer.open 的 shadeClose 参数仅支持布尔值,无法直接执行函数;需通过监听 .layui-layer-shade 元素的 click 事件实现点击遮罩逻辑,并注意事件绑定与解绑以避免重复和内存泄漏。

layer.open 的 shadeClose 参数不能直接执行函数

点击遮罩层默认只关闭弹窗,shadeclose 是个布尔值,设为 false 就禁用关闭,但不会触发回调——它本身不支持传函数。想在点击遮罩时执行逻辑,得换思路。

用 shade 的 click 事件监听遮罩层

Layui 的遮罩层(.layui-layer-shade)是独立 DOM 元素,且 layer 在打开弹窗后会保证该元素存在。只要确保弹窗已渲染,就能给它绑定 click 事件:

layer.open({
  content: 'Hello',
  shade: 0.3,
  success: function(layero, index) {
    // 等待遮罩层渲染完成(layer 内部已插入 .layui-layer-shade)
    setTimeout(function() {
      $('.layui-layer-shade').off('click').on('click', function() {
        console.log('遮罩被点击了');
        // 这里写你的业务逻辑,比如埋点、校验、或手动关闭
        // layer.close(index);
      });
    }, 10);
  }
});
  • success 回调里操作最稳妥,此时 DOM 已就绪
  • setTimeout 是为了等 layer 完成遮罩插入(极短延迟即可,10ms 足够)
  • 务必用 .off('click').on('click', ...) 避免重复绑定(尤其反复打开弹窗时)
  • 注意:如果页面有多个 layer 弹窗,.layui-layer-shade 可能有多个,但当前激活的遮罩总在最后($('.layui-layer-shade').last() 更精准)

慎用 layer.closeAll() 或全局 shade 监听

不要在 document 上监听 click 并判断是否点在遮罩上——Layui 的遮罩没有唯一 class 或 data 属性区分归属,容易误判;也别依赖 layer.closeAll(),它会关掉所有弹窗,不是你想要的“仅响应当前弹窗遮罩”。

  • 遮罩层无索引标识,无法从事件对象反推对应哪个 index
  • 若需关闭当前弹窗,应在事件里显式调用 layer.close(index),而不是靠 shadeClose: true
  • 移动端点击遮罩可能触发两次(touchstart + click),建议加防抖或只监听 touchend(如需兼容)

替代方案:改用自定义按钮或取消 shade

如果业务逻辑复杂(比如点击遮罩要弹确认框、或阻止关闭),不如放弃遮罩交互,改用显式按钮:

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

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

下载
layer.open({
  content: '<div>内容</div><div style="margin-top:15px">
<button id="confirm-btn">确定</button><button id="cancel-btn">取消</button>
</div>',
  shade: false, // 关闭遮罩
  success: function(layero) {
    $('#cancel-btn').on('click', function() {
      console.log('用户点了取消按钮');
      layer.closeAll();
    });
  }
});

这种写法可控性强,避免 DOM 事件干扰,也更符合用户预期——遮罩本就不该承担复杂交互语义。

真正容易被忽略的是:遮罩层在 layer 销毁时不会自动解绑事件,反复打开会导致监听器堆积。每次绑定前必须 .off(),且最好在 cancelend 回调里清理,否则内存泄漏风险真实存在。

相关文章

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

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

下载

相关标签:

layui

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

相关专题

更多
ajax教程
ajax教程

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

2023.06.14

2260

4

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

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

2023.08.31

340

5

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

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

2023.11.15

2093

5

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

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

2024.09.24

1121

6

NumPy性能优化版本更新与常见报错排查
NumPy性能优化版本更新与常见报错排查

本专题整理 NumPy 性能优化、版本更新与常见报错排查相关教程,覆盖向量化计算、广播性能、内存布局、NumPy 2.0 升级、版本兼容冲突、安装导入报错、dtype 溢出、矩阵运算异常和 broadcasting 报错修复,帮助读者系统掌握 NumPy 性能调优与问题定位方法。

2026.09.22

0

25

Vibeknow在线使用入口合集
Vibeknow在线使用入口合集

本专题汇总了Vibeknow在线创作视频的官方入口及网页版使用教程,涵盖PPT、PDF、Word等文档一键转讲解视频的核心操作,并整理了免费版水印规则与手机端浏览器访问指南,助你快速将知识内容视频化。

2026.09.21

20

20

NumPy随机数文件读写与dtype数据类型
NumPy随机数文件读写与dtype数据类型

本专题整理 NumPy 随机数、文件读写与 dtype 数据类型相关教程,覆盖 Generator/random、随机数种子、正态分布采样、npy/npz/CSV/TXT 保存读取、loadtxt/savetxt、memmap、大文件处理、astype 类型转换、结构化 dtype、整数溢出和精度丢失等场景。

2026.09.21

20

24

NumPy矩阵运算与线性代数计算
NumPy矩阵运算与线性代数计算

本专题整理 NumPy 矩阵运算与线性代数计算相关教程,覆盖矩阵乘法、dot 与 @ 运算符、逆矩阵、行列式、特征值与特征向量、SVD、线性方程组、欧氏距离、矩阵分解和大规模矩阵性能优化等内容,帮助读者掌握 np.linalg 与矩阵计算实战。

2026.09.21

0

20

NumPy广播机制数学运算与统计分析
NumPy广播机制数学运算与统计分析

本专题整理 NumPy 广播机制、数组数学运算与统计分析相关教程,覆盖广播规则、维度对齐、矩阵与数组加减除法、向量化计算、均值方差、分位数、中位数、直方图和 unique 频次统计等场景,帮助读者掌握 ndarray 高效计算与统计处理方法。

2026.09.21

0

17

热门下载

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

精品课程

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

共87课时 | 12.4万人学习

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

共89课时 | 10.6万人学习

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

共5课时 | 1.6万人学习