shadeClose: true 仅对遮罩层生效，无法点击弹窗外任意空白处关闭；需通过监听 document 点击并判断目标是否在最顶层弹窗外实现，推荐在 success 中绑定、end 中解绑，并注意 iframe 场景下父子页通信。
默认不支持，必须手动加监听逻辑；shadeclose: true 只管点击遮罩层，不是整个页面空白处。
为什么 shadeClose: true 不能点“任意空白处”关闭？
shadeClose: true 的作用范围仅限于 .layui-layer-shade 这个遮罩层 DOM。如果弹窗区域外、但遮罩没覆盖到的地方（比如滚动后露出的底部内容区），点击根本不会触发关闭——因为那里没有遮罩，也就没绑定事件。
- 遮罩只覆盖 viewport 可视区域，不随页面滚动延伸
-
shade: false时，shadeClose自动失效（没遮罩可点） - 移动端或 z-index 被父容器截断时，遮罩可能不可见或无法响应
如何真正实现“点击弹窗外任意位置关闭”？
核心是监听 document 点击，再判断目标是否在最顶层弹窗 DOM 外部。别用全局重复绑定，推荐在 success 回调里绑定，end 回调里解绑：
- 用
layer.getTop()获取当前最高层弹窗 DOM（比遍历.layui-layer更准） - 检查
e.target是否不在该 DOM 内，且不是.layui-layer-shade - 避免在
success里直接$(document).on('click', ...)，否则多次打开会叠加监听 - 示例关键片段：
layer.open({<br> content: 'xxx',<br> success: function(layero, index) {<br> const topLayer = layer.getTop();<br> $(document).one('click.autoClose', function(e) {<br> if (!topLayer[0].contains(e.target) && !$(e.target).hasClass('layui-layer-shade')) {<br> layer.close(index);<br> }<br> });<br> },<br> end: function() {<br> $(document).off('click.autoClose');<br> }<br>});
iframe 子页里调用 tips 或弹窗时怎么处理？
子页的 $(document) 监听不到父页点击事件。必须把监听提到父页上下文：
- 子页不要自己绑
$(document).on，改用parent.$(parent.document).on('click.tipClose', ...) - 确保父子页同源，且父页已加载 jQuery
- 更稳妥的做法：父页暴露
window.closeTips = function(idx) { layer.close(idx); }，子页点击时调用parent.closeTips(index) -
time: 0是layer.tips()必须项，否则自动销毁会和手动关闭冲突
真正难点不在写几行代码，而在 DOM 层级判断的准确性——layer.getTop() 返回的是否真是用户当前看到的那层，以及 contains() 是否被 shadow DOM 或 iframe 隔离干扰。这些细节不报错，但会让点击关闭静默失效。
