现象
弹窗写了 z-index:9999,父级只是普通 div,结果还是被页面底部的固定导航盖住。把导航的 z-index 改成 1 也没有用,两个元素的层叠顺序完全不按数字大小走,有时候刷新一下顺序又变了,看起来毫无规律。
原因
z-index 只在同一个层叠上下文里比较。父元素一旦有 transform、filter、opaCity 小于 1、will-change、position:fixed 或者 contain,就会创建新的层叠上下文,子元素再大的 z-index 也只在父级内部排序,整体仍可能被外部元素压住。数字本身不跨上下文生效,这才是最容易被忽略的一点。
解决步骤
第一步,定位真正的上下文边界。选中弹窗节点,逐级往上检查父元素的 computed style,看有没有 transform 或 filter,临时把它们改成 none 再观察层级是否恢复。
/* 排查用:逐个去掉会创建上下文的属性 */
.debug-parent {
transform: none !important;
filter: none !important;
opacity: 1 !important;
}
第二步,把弹窗挂到 body 下。用 document.body.appendChild 把节点移出原来的容器,或者改用 dialog 的 showModal 走 top layer,从结构上摆脱父级上下文,这比继续调数字可靠得多。
第三步,统一分层规范。约定导航 100、下拉 200、弹窗 300、toast 400,写进 CSS 变量,禁止各处随手写 9999,避免互相压制后越改越乱。
验证
滚动到页面不同位置并缩放窗口,弹窗始终在最上层;再用 Tab 键检查焦点没有被遮挡元素抢走,确认视觉层级和可交互性一致,移动端也要复测一次。
小结
z-index 失效基本都是层叠上下文惹的祸,先找出创建上下文的父级,再用 body 挂载或 top layer 解决,最后统一分层规范,比一味加数字有效。
