需拦截默认关闭逻辑,通过 shadeClass 添加回弹动画类,设 shadeClose: false 并手动监听遮罩点击触发动画,配合 setTimeout 延迟调用 layer.close;同时在 success 中恢复 pointer-events 以确保点击生效。

需要在用户点击遮罩层关闭弹窗时,让遮罩层不是生硬消失,而是带一个回弹动画效果,提升交互质感。
用 CSS 动画接管遮罩层的隐藏过程
Layer 默认的遮罩层(.layui-layer-shade)是通过 display: none 或 opacity: 0 + visibility: hidden 瞬间移除的,无法触发 CSS 动画。必须拦截关闭动作,改用 class 控制显隐,并绑定 animation。
第一步:给遮罩层添加自定义类名,在 layer.open 中设置 shadeClass: 'layer-shade-bounce'。
第二步:在全局样式中定义该类的回弹动画:
.layer-shade-bounce { animation: shadeBounceOut 0.3s cubic-bezier(0.175, 0.885, 0.32, 1.275) forwards; }
@keyframes shadeBounceOut { 0% { opacity: 1; } 70% { opacity: 0.3; transform: scale(1.05); } 100% { opacity: 0; transform: scale(0.95); } }
第三步:重写 shadeClose 行为——不依赖默认关闭,而是监听 document 点击,判断是否点在遮罩上,再手动触发动画并关闭:
layer.open({
content: '内容',
shade: 0.6,
shadeClass: 'layer-shade-bounce',
shadeClose: false,
success: function(layero, index) {
const shade = $('.layui-layer-shade.layer-shade-bounce');
shade.on('click', function() {
shade.addClass('closing');
setTimeout(() => layer.close(index), 300);
});
}
});
注意:必须加 shadeClose: false,否则 layer 会抢先执行原生关闭逻辑,动画来不及播放就清除了 DOM。
复用 Layer 自带动画参数实现简易回弹
如果不想写 CSS 动画,可借助 layer 的 anim 和 isOutAnim 配合遮罩生命周期钩子。
方法一:用 anim: 6(抖动动画)模拟回弹感
设置 shade: true 并启用 shadeClose: true,同时将弹窗自身 anim 设为 6,isOutAnim 设为 true —— 这样点击遮罩关闭时,弹窗先抖动退出,遮罩随之淡出,视觉上形成“被弹开”的错觉。
方法二:强制遮罩跟随弹窗动画节奏
在 open 配置中加入:skin: 'layui-layer-bounce',并在 CSS 中为 .layui-layer-bounce + .layui-layer-shade 写组合选择器动画规则,使遮罩 opacity 变化曲线与弹窗缩放/位移同步。
关键补丁:修复动画期间遮罩点击穿透失效
Layer 在动画执行中会临时禁用遮罩区域事件响应,导致点击无反应。必须在 success 回调里手动恢复 pointer-events:
success: function(layero, index) {
const shade = $('.layui-layer-shade');
shade.css('pointer-events', 'auto');
}
这一步不做,遮罩层点击后不会触发任何回调,动画根本启动不了。
最后,在 shade 的 CSS 动画结束时,确保 layer.close(index) 被准确调用,不能依赖 transitionend——因为 layer 会主动移除 shade 元素,transitionend 可能无法捕获。使用 setTimeout 是目前最稳定的方式。











