z-index 失效的根本原因是父容器创建了层叠上下文,导致子元素的 z-index 仅在该上下文中生效;常见触发属性包括 opacity
很多情况下 z-index 看似写了却不起作用,根本原因不是写错了值,而是父容器无意中触发了层叠上下文——比如设置了 opacity 小于 1、transform 非 none、will-change、filter,甚至 position: fixed 或 position: absolute 配合 z-index 都可能让子元素的 z-index 只在该容器内部生效。
常见误判点:
z-index 就能全局比大小,实际它只在**最近的层叠上下文内有效**opacity: 0.99 做淡入动画,结果导致整个子树脱离文档层叠流transform: translateZ(0) 本意是开启硬件加速,却顺手创建了新层叠上下文不是只有 z-index 能触发层叠上下文,HTML5 布局常用属性中,以下情况会自动创建(且无 z-index 值也能成立):
position: absolute 或 position: fixed + 任意 z-index 值(包括 auto)opacity 小于 1(哪怕只是 0.999)transform 不为 none(如 translateX(1px)、scale(0.99))filter 有值(哪怕 filter: blur(0))will-change: transform(即使尚未触发动画)perspective 或 backface-visibility
这些在 Flex/Grid 布局里尤其容易被忽略——比如给一个 display: grid 容器加了 opacity,它里面所有 z 都只能相互比较,无法越过它去和兄弟节点竞争层级。
立即学习“前端免费学习笔记(深入)”;
不能只看代码,得靠 DevTools 实时验证:
stacking context,若显示 Yes 即已创建注意:z-index: auto 在非定位元素上不创建层叠上下文,但在 position: relative/absolute/fixed 元素上,只要满足其他任一条件(如 opacity),就会立刻激活。
层叠上下文不是 bug,是规范行为,但布局时要主动管理:
position: relative + z-index 控制局部层级,而不是给父容器加 transform 或 opacity
will-change: transform 并**仅在动画开始前添加,结束后移除**position: fixed 或 position: absolute 提到 body 下(需同步处理定位逻辑)opacity/filter,改用子项单独设置真正麻烦的从来不是“怎么让 z-index 生效”,而是“为什么它突然只在一小块区域内生效了”——那大概率是某处透明度、变换或滤镜悄悄建了个看不见的墙。