布局与 CSS 核心 A2 · 正式技术规范 平台: 网页

z-index

CSS z-index

z-index 是设置定位元素前后图层的 CSS 属性。在某些条件下,它也会建立新的局部堆叠上下文。

看看怎样运作
也有人这样说 z-indexCSS z-index

看看怎样运作

原创情境示例CSS z-index

另一个例子

遮罩、弹出层和页头会在已知的堆叠上下文内,使用事先规划的图层值。每一层按照预期顺序显示;z-index 不能跳出父级上下文,也不能修正元素放在错误 DOM 位置的问题。

主要部分

  1. 01positioned box
  2. 02stack level
  3. 03适用 context

什么时候用

先找出控制元素的堆叠上下文,再设置规划好的图层时,可以使用这个词。

什么时候不要用

不要在还没检查堆叠上下文如何建立,以及源码顺序前,就一直改成更大的任意数字。

代码里的名称

z-index: <integer> | auto

上线前要检查

检查内容先后顺序、共用设计变量、组件一致性、对比度、缩放,以及页面能否随屏幕大小调整。验证每个主题、语言与状态;有动态效果时,也要提供同样完整的减少动态效果版本。

可以直接复制的需求

预期结果:定义或使用 CSS z-index (z-index),做出清楚、一致又好用的视觉体验。 用户场景:遮罩、弹出层和页头会在已知的堆叠上下文内,使用事先规划的图层值。每一层按照预期顺序显示;z-index 不能跳出父级上下文,也不能修正元素放在错误 DOM 位置的问题。 要运用的设计概念:CSS z-index (z-index)。 适用理由:先找出控制元素的堆叠上下文,再设置规划好的图层时,可以使用这个词。 不应使用的情况:不要在还没检查堆叠上下文如何建立,以及源码顺序前,就一直改成更大的任意数字。 设计要求:定义内容先后顺序、可复用的设计变量(Token)与组件。说明页面如何随屏幕大小和状态改变。分清必要的设计方向与纯装饰。 包容性与韧性:检查对比度、缩放、多语言、主题切换与减少动态效果。不能只靠颜色或特效表达含义。 验收标准:在手机、桌面、缩放、各种主题与所有支持语言中仍清晰可读。每个交互状态都一致且容易理解。 证据与限制(证据边界):正式文档仍可能是草案、候选版或最终版。请查看文档状态,也要确认浏览器或平台是否支持。 待确认:品牌限制、内容多少、支持的主题与语言、目标设备,以及现有设计系统规则。

检查这份需求

请 AI 编程助手检查当前如何使用 CSS z-index (z-index)。 定义:z-index 是设置定位元素前后图层的 CSS 属性。在某些条件下,它也会建立新的局部堆叠上下文。 生产环境检查:检查内容先后顺序、共用设计变量、组件一致性、对比度、缩放,以及页面能否随屏幕大小调整。验证每个主题、语言与状态;有动态效果时,也要提供同样完整的减少动态效果版本。 修改程序前,先列出看到的证据、缺口、严重程度,以及最小且安全的修正。

A2
这个术语有多正式?

正式技术规范

一份已发布、有版本的正式技术规范,在列出的范围内定义这个术语。

正式文档仍可能是草案、候选版或最终版。请查看文档状态,也要确认浏览器或平台是否支持。

适用范围
只包含来源有说明的内容:正式名称、定义、语义、实现
文档状态
草案
核验日期
2026-07-30

证据来源与适用范围

正式来源 + 术语参考资料 · W3C CSS Working Group · 草案 CSS Positioned Layout Module Level 3 — Painting order and z-index stack levels Painting order and z-index stack levels 适用范围: 正式名称、定义、语义、实现 本页用途: 直接术语参考 来源涵盖内容: 正式名称, 定义, 语义, 实现 正式来源 · W3C CSS Working Group · 草案 CSS Positioned Layout Module Level 3 适用范围: 正式名称、定义、语义、实现 本页用途: 只支持写明的范围 来源涵盖内容: 正式名称, 定义, 语义, 实现

自行复制

浏览器无法自动复制。请选择下方文字,再自行复制。