layui.open() 默认不支持点击遮罩关闭，必须显式设置 shadeclose: true；shade 仅控制透明度，与关闭逻辑无关；遮罩失效常见原因是 z-index 冲突、overflow 隐藏或层叠上下文干扰。
layui.open() 默认不关闭，需要手动配置 shadeClose
点击弹层外部区域（即遮罩层）自动关闭弹窗，不是默认行为。Layui 的 layer.open() 必须显式设置 shadeClose: true，否则哪怕有遮罩，点外面也不会关。
常见错误是只写了 shade: 0.3 就以为能关——其实 shade 只控制遮罩透明度，和关闭逻辑无关。
-
shadeClose: true是开关，必须为布尔值true（不能写成字符串"true"或数字1） - 如果同时设置了
shade: false，则遮罩不显示，shadeClose自然失效（没遮罩可点） - 移动端点击遮罩有时响应迟钝，建议搭配
skin: 'layui-layer-molv'等轻量皮肤避免渲染卡顿
遇到点击外部无反应？检查 z-index 和父容器 overflow
即使写了 shadeClose: true，仍不生效，大概率是遮罩层被挡住了。Layui 的遮罩（.layui-layer-shade）默认 z-index: 19891014，但如果父容器设置了 overflow: hidden 或更低的 z-index，遮罩会被裁剪或压在底层。
- 用浏览器开发者工具检查
.layui-layer-shade是否存在、是否被display: none或visibility: hidden干扰 - 确认弹层触发元素的父级没有
transform、filter等创建新层叠上下文的 CSS 属性（会截断遮罩渲染） - 临时加一句
document.body.style.overflow = 'visible'排查是否因 body 被锁死导致事件无法冒泡到遮罩
自定义关闭逻辑时，别覆盖 shadeClose 的原生事件
有人为了加确认提示，在 cancel 回调里写 return confirm('确定关闭？')，但这样会阻断原生关闭流程，且 cancel 不会在点击遮罩时触发——它只响应右上角 × 或 layer.close() 调用。
真正监听遮罩点击，应使用 end 回调（弹层完全销毁后触发）或直接监听遮罩元素：
layer.open({
content: 'Hello',
shadeClose: true,
end: function() {
console.log('弹层已销毁，无论怎么关的');
}
});
- 不要在
yes、cancel里处理遮罩关闭逻辑，它们不负责这个 - 若需拦截遮罩关闭（比如表单未保存），只能靠
shade: 0关闭遮罩，再自己画一个带事件的 div 模拟，并手动控制关闭 -
success回调里不要给遮罩绑定click，Layui 已内部绑定，重复绑定可能引发多次触发
shadeClose 看似简单，实际依赖遮罩渲染完整性、事件捕获顺序、以及层叠上下文是否干净——这些细节不报错，但会让功能“静默失效”。调试时优先看遮罩 DOM 是否真实存在且可点击。
