z-index 设 9999 还是被盖住 transform 层叠上下文怎么查

现象

弹窗写了 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 解决,最后统一分层规范,比一味加数字有效。

您可以还会对下面的文章感兴趣:

暂无相关文章