全屏遮罩必须用 position: fixed 配合 top:0;left:0;width:100vw;height:100vh,禁用百分比;需用 visibility+opacity 组合过渡,禁用 display:none;z-index≥9999;注意 pointer-events 和移动端 will-change。

遮罩元素必须用 fixed 定位才能全屏覆盖
用 position: absolute 很容易漏掉 body 滚动时的偏移,导致遮罩错位或无法盖住底部内容。真正可靠的方案是 position: fixed 配合 top: 0; left: 0; width: 100vw; height: 100vh —— 注意不是 100%,因为百分比在 fixed 下相对 viewport 的行为不稳定,尤其在 iOS Safari 中容易失效。
常见错误现象:opacity 动画开始前遮罩突然闪一下、滚动后遮罩“缩进”、iPhone 上遮罩高度不足一屏。
-
z-index值建议设为至少9999,避免被第三方组件(如 antd modal、Toast)意外压住 - 务必加
pointer-events: none到遮罩父容器(如果需要穿透点击),但遮罩本体要设pointer-events: auto否则 click 事件不触发 - 若页面有横向滚动,
width: 100vw可能不够,可改用width: 100%+left: 0+transform: translateX(0)强制重绘
transition 必须作用在 opacity 和 visibility 上
只写 transition: opacity 0.3s 不够——opacity: 0 时元素仍占文档流且响应事件,用户可能误点到背后按钮。正确做法是搭配 visibility: hidden/visible 控制可交互性,再用 transition 同时声明两个属性:
transition: opacity 0.3s ease, visibility 0.3s ease;
注意:不能写成 transition: all 0.3s,否则 visibility 会强制立即切换(CSS 规范规定它不可过渡),导致动画卡顿或跳变。
立即学习“前端免费学习笔记(深入)”;
- 显示遮罩时:先设
visibility: visible,再设opacity: 1(靠 transition 自动过渡) - 隐藏遮罩时:先设
opacity: 0,等动画结束再设visibility: hidden(通常用transitionend事件或setTimeout) - 若用 CSS-in-JS 或框架(如 React),推荐用
useTransition或CSSTransition管理 visibility 生命周期,避免手动计时误差
transform scale 配合 opacity 实现“渐入放大”效果
纯 opacity 过渡太单调,加一点缩放更自然。关键点在于:scale 动画必须从 transform: scale(1.05) 开始,结束于 scale(1),否则会有视觉“抽搐”。同时 scale 本身要参与 transition:
transition: opacity 0.3s ease, transform 0.3s ease;
注意不要用 scale(0) 起始——会导致子元素(如弹窗)渲染异常,尤其在 Chrome 115+ 中可能触发 layout thrashing。
- 遮罩自身用
background-color: rgba(0,0,0,0.5),别用半透图片,否则 scale 会模糊边缘 - 如果遮罩里嵌了绝对定位的弹窗,弹窗的
transform应独立设置,避免继承遮罩的 scale 导致变形 - 移动端需加
will-change: opacity, transform提前提示合成层,防止 iOS Safari 掉帧
display: none 会中断 transition,必须避免
很多同学在 JS 里直接 el.style.display = 'none' 隐藏遮罩,结果动画根本没执行就消失了。这是最常踩的坑——display 是离散属性,无法过渡,浏览器会直接跳过所有 transition。
真正安全的隐藏流程只有两种:用 opacity + visibility 组合,或者用 max-height + overflow: hidden(仅适用于有固定高度的遮罩,不推荐)。
- React/Vue 用户容易在 v-if / *ngIf 里切遮罩组件,这本质就是 display 切换,应改用
v-show或[hidden]属性控制 - 如果必须用 display,至少加
setTimeout(() => el.style.display = 'none', 300),但不如直接用 visibility 可靠 - 检查 DevTools 的 Elements 面板,确认遮罩元素在动画过程中始终存在且 style 里没有
display: none



















