WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

z-index — Stapelreihenfolge

Die Eigenschaft z-index legt die Ebene eines Elements innerhalb eines Stapelkontexts fest. Größere Zahlen platzieren es näher am Betrachter, jedoch nur innerhalb desselben Kontexts; ein hoher Wert lässt ein Nachfahrenelement nicht aus dem Stapelkontext seines Vorfahren entkommen.

Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntax

z-index: auto | <integer>;

z-index steuert die Überlagerung positionierter Boxen sowie Flex- und Grid-Elemente. Zulässig sind auto oder eine <integer>, auch negative Werte. Der Anfangswert ist auto; die Eigenschaft wird nicht vererbt. Brüche und Längeneinheiten sind ungültig.

Innerhalb desselben Stapelkontexts wird eine höhere Ebene vor einer niedrigeren gezeichnet. Ein untergeordneter Kontext wird als Ganzes behandelt: Selbst ein enormer z-index eines Nachfahren kann ihn nicht aus dem Kontext seines Vorfahren herausheben.

Bei position: relative und position: absolute bedeutet auto die Ebene null, ohne dass z-index einen Kontext erzeugt; eine Ganzzahl erzeugt einen Kontext. Daher sind auto und 0 nicht gleichwertig. Boxen mit position: fixed oder position: sticky erzeugen auch mit auto einen Kontext. Flex- und Grid-Elemente mit einem anderen Wert als auto erzeugen auch bei position: static einen Kontext.

Im Beispiel überdeckt #front das Element #back, obwohl es im Dokument früher steht. Wenn eine Änderung der Zahl nicht hilft, untersuche die Stapelkontexte der Vorfahren, statt z-index immer weiter zu erhöhen.

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>z-index</title>
<style>
  .stage {
    position: relative;
    z-index: 0;
    width: 200px;
    height: 140px;
  }
  .box {
    position: absolute;
    width: 120px;
    height: 80px;
    color: black;
  }
  #front {
    top: 0;
    left: 0;
    background: orange;
    z-index: 2;
  }
  #back {
    top: 40px;
    left: 60px;
    background: lightblue;
    z-index: 1;
  }
</style>
<div class="stage">
  <div class="box" id="front">FRONT</div>
  <div class="box" id="back">BACK</div>
</div>
</html>

Ergebnis

FRONT (orange) overlaps BACK (lightblue). No console output.

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen