shadeClose设为false不生效的根本原因是shade未显式配置，Layui仅在shade为非false且非0（如0.3）时才读取shadeClose；必须同时设置shade:0.3和shadeClose:false，缺一不可。

shadeClose 设为 false 为什么还不生效

根本原因不是 shadeclose 失效，而是它压根没被触发——shade 没显式配置。layui 内部逻辑是：只有 shade 值为非 false 且非 0（比如 0.3）时，才会读取 shadeclose 的值。

常见错误写法：{ shadeClose: false } → 遮罩不渲染，shadeClose 被忽略

• 正确写法必须同时带 shade：{ shade: 0.3, shadeClose: false }
• shade: 0 和 shade: false 效果不同：0 仍生成 DOM（隐身但占位），false 则完全不创建遮罩元素
• 拼写必须是 shadeClose，写成 shadeclose 或 shade_close 会静默失败

Vue/React 项目中点击遮罩仍关闭

框架的响应式机制或 DOM 生命周期干扰了 layer 的事件绑定时机，导致 shadeClose: false 在实际渲染时未生效。

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

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

下载

• 确保 layer.open() 在组件挂载后调用（Vue 的 mounted / React 的 useEffect）
• 避免把 layer.open() 放在模板的响应式表达式里（如 v-if="show" 中直接调用）
• 每次打开都需重新传入完整配置，shadeClose: false 不继承全局设置
• 检查是否用了 layer.closeAll()，它会无差别清空所有实例，包括你刚打开的

layer.msg / layer.alert 点击遮罩还是关了

这些快捷方法内部默认启用 shadeClose: true，且不读取你对 layer 对象的全局修改。

• 必须显式覆盖：layer.msg('提示', { shadeClose: false })
• layer.alert、layer.confirm 同理，每个调用都要单独加 { shadeClose: false }
• 特别注意 layer.msg 的 time 参数：time: 0 且 shadeClose: true 时，用户唯一退出方式就是点遮罩——这容易被误认为是 bug

移动端遮罩点击失效或偶发关闭

iOS Safari 和部分安卓 WebView 对 click 事件监听不稳定，尤其在快速滚动后点击遮罩边缘，事件可能被吞掉或延迟触发。

• 升级到 Layui v2.9.13+，新版修复了 touch/click 竞争问题
• 避免用 $('.layui-layer-shade').on('click')，遮罩 DOM 是动态生成的，外部委托易绑错
• 更稳妥的做法是在 success 回调里精准获取当前遮罩：$(layero).prev('.layui-layer-shade')
• 若用了自定义 CSS，请确认 .layui-layer-shade 的 z-index 高于其他浮层（如 Element Plus 的 el-dialog），否则点击实际落在上层 DOM 上

真正难的不是设 shadeClose: false，而是当多个弹层嵌套、或父容器设置了 pointer-events: none 时，点击行为会穿透到下层，看起来像“点了遮罩却关了窗”——其实关窗的不是遮罩，是底下某个被穿透的按钮或全局监听。