z-index 层叠上下文可视化

用真实的浏览器渲染演示 z-index 和层叠上下文:修改每个方块的 position、z-index、opacity、transform、isolation,马上看到谁盖住谁,并标出哪些元素创建了层叠上下文、原因是什么。内置几个最常见的“z-index 不生效”场景,帮你排查弹窗、下拉菜单被遮挡的问题。

对应的 CSS

z-index 不生效的常见原因

  • 元素没有定位:z-index 只对 position 为 relative、absolute、fixed、sticky 的元素,以及 flex、grid 的子项生效,static 元素写了也没用。
  • 被困在父元素的层叠上下文里:一旦父元素创建了层叠上下文,子元素的 z-index 只在父元素内部比较。父元素自己层级低,子元素写 9999 也盖不过外面层级更高的元素。
  • 意外创建了层叠上下文:除了“定位 + z-index”,以下属性也会创建:opacity 小于 1、transform、filter、backdrop-filter、perspective、clip-path、mask、mix-blend-mode、isolation: isolate、will-change 指定上述属性、contain: paint,以及 position: fixed / sticky。给父元素加了淡入动画(opacity)或 transform 后弹窗被遮挡,就是这个原因。
  • 解决办法:把弹窗、下拉菜单用 Portal(Teleport)挂到 body 下;或者提高“创建层叠上下文的那个祖先”的 z-index,而不是子元素;也可以用 isolation: isolate 主动给组件建一个独立的层叠上下文,避免内部的 z-index 影响外部。

同一个层叠上下文内的绘制顺序(从下到上)

  1. 层叠上下文根元素的背景和边框
  2. z-index 为负数的定位元素
  3. 普通流中的块级元素
  4. 浮动元素
  5. 普通流中的行内元素
  6. z-index 为 auto 或 0 的定位元素
  7. z-index 为正数的定位元素(数值越大越靠上,相同时后出现的在上)

z-index 层叠上下文可视化常见问题

z-index 层叠上下文可视化可以查到哪些内容?

用真实的浏览器渲染演示 z-index 和层叠上下文:修改每个方块的 position、z-index、opacity、transform、isolation,马上看到谁盖住谁,并标出哪些元素创建了层叠上下文、原因是什么。内置几个最常见的“z-index 不生效”场景,帮你排查弹窗、下拉菜单被遮挡的问题。可以按「对应的 CSS」、「元素结构(点选编辑)」、「z-index 不生效的常见原因」、「同一个层叠上下文内的绘制顺序(从下到上)」等章节查阅。页面用于资料查阅,外部资源需通过对应链接访问。

为什么 z-index 设置了 9999 还是被遮挡?

它的某个祖先元素创建了层叠上下文,并且这个祖先的层级比遮挡物低,子元素只能在祖先内部比较。

哪些属性会创建层叠上下文?

定位元素设置 z-index,以及 opacity 小于 1、transform、filter、isolation: isolate、position: fixed 等。

z-index 为什么不生效?

最常见的原因是元素没有设置 position(仍是 static)。

弹窗被遮挡怎么解决?

把弹窗挂到 body 下,或提高创建层叠上下文的那个祖先元素的 z-index。

页面中的版本、示例或外部链接如何使用?

先找到与当前需求对应的「对应的 CSS」等章节,查看示例的适用条件,再核对对应项目或服务的官方说明。页面中的名称、版本和示例属于资料内容,不表示已实时检查第三方服务的状态。

z-index 层叠上下文可视化的结果应怎样理解?

演示用简化的嵌套结构;static 元素为了摆放位置在演示中使用了绝对定位,但不参与 z-index 比较。

输入内容会保存或发给外部服务吗?

演示在浏览器本地运行,不会上传。

相关工具

JSON 格式化校验 · Base64 编码解码 · URL 编码解码 · JWT 解码与验证 · 全部开发工具