必须同时设置 shade: 0.3 和 shadeClose: false 才能禁用遮罩关闭,shade 设为 false 或 0 会移除遮罩导致失效;快捷方法需显式传参,不继承 layer.config;还需禁用 esc: false 并排查点击穿透与事件污染。

在Layui项目中,用户点击弹窗背后的灰色遮罩层(shade)时意外关闭弹窗,导致表单未提交、确认流程中断或操作被中止,必须确保点击遮罩层完全不触发关闭行为。
确认 shade 和 shadeClose 同时显式配置
只写 shadeClose: false 不生效——因为 shade 默认值虽为 0.3,但若你没在配置对象里明确写出 shade 字段,Layui 内部会跳过 shadeClose 的判断逻辑,等同于该配置未激活。必须两者共存:
layer.open({<br> content: '我是一个弹窗',<br> shade: 0.3,<br> shadeClose: false<br>});
shade 设为 【0.3】 是关键前提;设为 false 或 0 会导致遮罩 DOM 消失,shadeClose 失去作用对象。
layer.confirm / layer.alert 等快捷方法单独设参
方法一:直接传参覆盖默认行为
layer.confirm('确定删除?', { shade: 0.3, shadeClose: false });
方法二:避免全局配置干扰
即使你在 layer.config({ shadeClose: false }) 中设过全局值,layer.confirm 仍会忽略它——所有快捷方法都使用硬编码默认值,不继承 config。每个调用都必须显式带上 shade 和 shadeClose。
注意:layer.msg 若设置了 time: 0(永不自动关闭),又没关 shadeClose,用户就只能靠点遮罩来关,这会形成反直觉交互。
排查真实关闭来源
第一步:检查是否按了 Esc 键
Layui 默认响应 Esc 关闭弹窗,与遮罩无关。加 esc: false 可禁用:
layer.open({ content: '内容', shade: 0.3, shadeClose: false, esc: false });
第二步:检查 CSS 是否导致点击穿透
如果父容器设置了 pointer-events: none,或有其它弹层(如 Ant Design Modal)z-index 更高,实际点击的是底层按钮而非遮罩。用浏览器开发者工具检查 .layui-layer-shade 元素是否被遮挡或失效。
第三步:检查多层嵌套时的事件污染
上层弹窗设了 shadeClose: false,但下层监听了全局 click 并执行 layer.close(),就会造成“点哪都关”。需逐层审查事件绑定逻辑。
验证是否生效的快速方式
打开浏览器控制台,在弹窗打开后执行:
document.querySelector('.layui-layer-shade').onclick = function(){ console.log('遮罩被点了'); };
如果点击遮罩后控制台无输出,且弹窗不关闭,说明 shadeClose: false 已生效;若有输出或弹窗关闭,则配置未起效或存在其他关闭机制。


















