层叠上下文

概念定义

一旦定位与合成介入，绘制顺序就不再是 DOM 顺序。浏览器把元素分组为层叠上下文，每个上下文内部有固定顺序——背景、负 z-index 子级、块级、浮动、行内、z-index auto 子级、正 z-index 子级；上下文自身在父级排序中是原子单位。

工作机制

常见创建者：根元素；带数值 z-index 的定位元素；带 z-index 的 flex/grid 子项；fixed 与 sticky；小于 1 的 opacity；transform、filter、backdrop-filter；这些属性的 will-change；以及显式的 isolation: isolate。子级一百万的 z-index 也逃不出本身处于 z-index 1 的父上下文。

使用场景

浮层体系、模态、工具提示、粘性头部与第三方组件嵌入。应刻意设计上下文层级：isolation: isolate 包裹让组件自成一体而不需要魔法数字；portal 只移动 DOM，移不出被合成的父级。

常见误区

z-index 高者未必胜：它只在同一上下文内比较，其余由父上下文决定，这与选择器优先级无关。为动画加的 transform 会静默创建上下文，把 fixed 后代困住——在其内 fixed 与 sticky 表现得像 absolute。调滤镜或半透明的包裹层会在下拉菜单上复现同样的陷阱，应使用图层面板排查。

代码示例

/* Markup contract: each .form__field contains a label, an input,
   an optional .form__hint, and a .form__error paragraph. */

.form {
  display: grid;
  gap: var(--space-4, 1.5rem);
  max-inline-size: 32rem;
}

.form__field {
  display: grid;
  gap: var(--space-2, 0.5rem);
  border-radius: var(--radius-sm, 0.375rem);
}

.form__field > label {
  font-weight: 600;
}

.form__field input {
  font: inherit;
  padding-block: 0.5rem;
  padding-inline: 0.65rem;
  border: 1px solid var(--color-border, #a1a1aa);
  border-radius: var(--radius-sm, 0.375rem);
  background: var(--color-surface, #ffffff);
  color: var(--color-text, #18181b);
}

.form__error {
  display: none;
  margin: 0;
  font-size: 0.875rem;
  color: var(--color-danger, #b91c1c);
}

.form__field:has(input:required) > label::after {
  content: " *";
  color: var(--color-danger, #b91c1c);
}

.form__field:has(input:focus-visible) {
  outline: 2px solid var(--color-focus, #4f46e5);
  outline-offset: 4px;
}

/* :user-invalid appears only after the user has interacted or tried to submit. */
.form__field:has(input:user-invalid) input,
.form__field:has(input[aria-invalid="true"]) input {
  border-color: var(--color-danger, #b91c1c);
  background: var(--color-danger-surface, #fef2f2);
}

.form__field:has(input:user-invalid) .form__error,
.form__field:has(input[aria-invalid="true"]) .form__error {
  display: block;
}

@media (forced-colors: active) {
  .form__field:has(input:user-invalid) input,
  .form__field:has(input[aria-invalid="true"]) input {
    border: 2px solid Mark;
  }
}

/* Fallback without :has: use the general sibling combinator and show the
   message only for inputs explicitly marked invalid by script or server. */
@supports not selector(:has(*)) {
  .form__field input[aria-invalid="true"] {
    border-color: var(--color-danger, #b91c1c);
  }

  .form__field input[aria-invalid="true"] ~ .form__error {
    display: block;
  }
}