z-index und Stacking Contexts als Ebenenreihenfolge in Figma
Wie CSS z-index und Stacking Contexts auf die Ebenenreihenfolge in Figma abgebildet werden, was einen Kontext erzeugt und warum 9999 trotzdem verlieren kann.
Einleitung
In Figma ist z-index die Reihenfolge im Layers-Panel: Die oberste Ebene liegt vorn, die unterste hinten. In CSS ist es eine ganze Zahl, aber diese Zahl konkurriert nur innerhalb eines Stacking Context, deshalb gewinnt eine größere Zahl nicht immer. Dieser Artikel überträgt das eine auf das andere, damit Sie die Ebenenreihenfolge einer importierten Seite lesen können und wissen, warum ein Overlay dort sitzt, wo es sitzt.
Er richtet sich an Designer, die eine Seite als Ebenen erben, und an Entwickler, die eine übergeben. Alle Fakten stammen von MDN oder aus den Hilfeseiten von Figma, Stand November 2026.
Die Figma-Variante: Oben im Layers-Panel ist vorn
Figma hat kein z-index-Feld. Die Figma-Hilfe beschreibt, dass Sie die Tiefe (Z-Achse) einer Ebene über ihre Reihenfolge im Layers-Panel einstellen und dass die Tiefe einer Ebene dem z-index eines Objekts entspricht. Die oberste Ebene liegt vorn, die unterste hinten.
Die Reihenfolge ändern Sie auf drei Wegen:
- Ziehen Sie die Ebene im Layers-Panel nach oben, um sie nach vorn zu holen, oder nach unten, um sie nach hinten zu schicken.
- Klicken Sie mit der rechten Maustaste und wählen Sie Bring forward, Bring to front, Send backward oder Send to back.
- Nutzen Sie die passenden Tastenkürzel für diese vier Aktionen.
Außerhalb eines Auto-layout-Frames verschiebt eine geänderte Ebenenreihenfolge die Ebene weder auf der X- noch auf der Y-Achse. Sie ändert nur, was was verdeckt. Das ist das Nächste, was Figma an eine CSS-Ganzzahl hat: ein Platz in einer Liste, keine Zahl, die Sie wählen.
Auf welche Elemente z-index wirkt
Auf der CSS-Seite sagt die z-index-Referenz von MDN, dass die Eigenschaft für positionierte Elemente (jedes position außer static) sowie für Flex- und Grid-Elemente gilt. Überlappende Elemente mit größerem z-index verdecken solche mit kleinerem.
Zwei Werte zählen:
autoist der Anfangswert. Die Box erzeugt keinen neuen Stacking Context, und ihre Ebene im aktuellen Kontext ist 0.- Ein
<integer>legt die Ebene der Box im aktuellen Kontext fest und lässt die Box zusätzlich einen lokalen Stacking Context erzeugen. Negative Ganzzahlen platzieren das Element hinter dem normalen Inhalt seines Kontexts.
Haben zwei Elemente dieselbe Ebene, werden sie in DOM-Reihenfolge gestapelt, und das spätere wird oben gezeichnet. Deshalb funktioniert eine Seite oft ganz ohne Ganzzahlen. Die Ansicht Eigenschaft für Eigenschaft zu position finden Sie unter CSS position in Figma.
Zeichenreihenfolge ganz ohne z-index
Wenn kein Element z-index setzt, nennt die MDN-Seite zum Stapeln ohne z-index diese Reihenfolge von unten nach oben:
- Hintergrund und Rahmen des Wurzelelements.
- Nicht positionierte Nachkommen, in der Reihenfolge ihres Auftretens im HTML.
- Positionierte Nachkommen, in der Reihenfolge ihres Auftretens im HTML.
Ein statisches Element wird also unter einem positionierten gezeichnet, auch wenn es im Markup später steht. MDN weist außerdem darauf hin: Ändert die Flex-Eigenschaft order die gerenderte Reihenfolge, ändert sich die Stapelreihenfolge genauso. "Reihenfolge des Auftretens" meint die gerenderte Reihenfolge, nicht die im Quelltext.
Für Designer erklärt das, warum ein Tooltip mit position: absolute eine Karte verdeckt, die im HTML danach kommt. Niemand hat eine Zahl geschrieben. Der position-Wert hat die Arbeit erledigt.
Was einen Stacking Context erzeugt
Hier beginnt der Ärger. Die MDN-Seite zum Stacking Context listet auf, was einen erzeugt. Die häufigsten Auslöser:
| Auslöser | Erzeugt einen Kontext, wenn |
|---|---|
| Wurzelelement | immer |
position: absolute oder relative | z-index nicht auto ist |
position: fixed oder sticky | immer |
| Flex- oder Grid-Element | z-index nicht auto ist |
opacity | kleiner als 1 |
mix-blend-mode | nicht normal |
transform, filter, backdrop-filter, clip-path, mask | nicht none |
isolation | isolate |
contain | layout oder paint |
Die Liste enthält außerdem container-type mit size oder inline-size, will-change mit einer Eigenschaft, die einen Kontext erzeugen würde, und Elemente in der Top Layer. Praktisch heißt das: Sie können einen Stacking Context erzeugen, ohne je ein z-index zu schreiben. Eine Karte mit opacity: 0.9 oder einem transform beim Hover ist bereits einer.
Zwei frühere Artikel behandeln die Eigenschaften hinter mehreren dieser Zeilen: opacity, blend modes, and filters und CSS transforms in Figma terms.
Stacking Contexts sind atomar: warum 9999 verliert
MDN formuliert es so: Jeder Stacking Context ist in sich geschlossen, und nachdem sein Inhalt gestapelt wurde, gilt das ganze Element als eine Einheit in der Stapelreihenfolge seines Elternelements. Die z-index-Werte von untergeordneten Kontexten haben nur innerhalb des Kontexts des Elternelements eine Bedeutung.
Das Beispiel von MDN macht es greifbar. Drei Artikel haben z-index 5, 2 und 4, und der dritte enthält Abschnitte mit 6, 1 und 3. Jeder Container hat opacity: 0.85, ist also ein Kontext. Der Abschnitt mit z-index 6 wird unter dem Artikel mit z-index 5 gerendert, weil er zum Artikel mit z-index 4 gehört. MDN schreibt die Ebenen wie Versionsnummern: 4-6 ist kleiner als 5-0.
/* The section's 6 only counts inside #container3 (z-index: 4) */
#container1 { z-index: 5; }
#container3 { z-index: 4; }
#container4 { z-index: 6; } /* child of #container3, still under #container1 */
Ein Modal mit z-index: 9999 verliert also gegen einen Header mit z-index: 10, wenn das Modal in einem Elternelement liegt, dessen Kontext tiefer sitzt. Die Zahl zu erhöhen hilft nicht. Verschieben Sie das Modal nach außen oder ändern Sie das Elternelement.
In Figma sehen Sie dasselbe als Verschachtelung. Kinder liegen im Layers-Panel unter ihrem übergeordneten Frame oder ihrer Gruppe, und der Platz des Elternelements in der Liste ist der Ort, an dem die ganze Gruppe landet. Dieser Artikel behauptet nicht, dass sich Figma-Frames in jedem Fall wie isolierte Gruppen verhalten, weil die Hilfeseiten von Figma das nicht ausdrücklich sagen. Verstehen Sie die Verschachtelung als Hinweis und prüfen Sie die Arbeitsfläche.
Auto layout: Die Reihenfolge verschiebt Dinge, Überlappung braucht eine Option
Laut Figma-Hilfe funktioniert die Ebenenreihenfolge in einem Auto-layout-Frame umgekehrt. Eine geänderte Reihenfolge ändert die Position der Ebene im Frame, denn die Reihenfolge ist der Fluss. In einem vertikalen Fluss folgen hinzugefügte, entfernte oder umsortierte Objekte der y-Achse, in einem horizontalen der x-Achse.
Um in einem Auto-layout-Frame etwas zu überlappen, aktivieren Sie Ignore auto layout. Der Figma-Leitfaden zu Auto layout sagt, dass dies früher absolute position hieß und das Objekt, wie die absolute position in CSS, präzise relativ zum Elternelement platziert werden kann, während es im Frame bleibt. Das ist das Figma-Gegenstück zu einem positionierten Kind in einem Flex-Container, und dort leben Overlays, Badges und schwebende Buttons.
Was nach einem Import zu prüfen ist
UnHTML wandelt eine Seite in bearbeitbare Ebenen um, nicht in einen pixelgenauen Klon, und der Importbericht listet auf, was auf eine Ersatzlösung zurückgefallen ist. Die Ebenenreihenfolge prüfen Sie am besten selbst:
- Wählen Sie jedes Overlay aus: Sticky-Header, Modal, Dropdown, Toast, Badge. Bestätigen Sie, dass jedes im Layers-Panel über dem Inhalt liegt, den es verdeckt.
- Suchen Sie eine Ebene, die in CSS "oben" ist, aber in der Liste weiter unten gelandet ist. Ein Eltern-Kontext, etwa
opacityodertransforman einem Vorfahren, ist meist die Ursache. - Prüfen Sie in Auto-layout-Frames, ob ein überlappendes Kind mit Ignore auto layout markiert ist. Wenn nicht, verschiebt das Umsortieren es, statt es neu zu stapeln.
Fazit
Figma gibt Ihnen pro Elternelement eine geordnete Liste, in der oben vorn bedeutet. CSS gibt Ihnen Ganzzahlen, DOM-Reihenfolge und verschachtelte Kontexte, und ein Kontext wird von vielen Eigenschaften außer z-index bestimmt. Wenn ein CSS-Stapel und ein Figma-Stapel nicht übereinstimmen, suchen Sie zuerst den Vorfahren, der den Kontext erzeugt hat, und vergleichen Sie dann die Reihenfolge seiner Geschwister.
Häufig gestellte Fragen
Ist die Ebenenreihenfolge in Figma dasselbe wie CSS z-index?
Die Figma-Hilfe sagt selbst, dass die Tiefe einer Ebene dem z-index eines Objekts entspricht und dass die oberste Ebene im Layers-Panel vorn liegt. Die Zuordnung erfolgt über die Reihenfolge, nicht über die Zahl: Figma hat kein z-index-Feld, deshalb muss jede Umwandlung CSS-Ganzzahlen in eine Reihenfolge unter Geschwistern übersetzen.
Warum bleibt mein Element mit riesigem z-index hinter einem anderen?
Meist, weil ein Elternelement einen Stacking Context erzeugt. Der z-index eines Kindes konkurriert nur innerhalb des Kontexts seines Elternelements, und das Elternelement zählt in der nächsthöheren Ebene als eine Einheit. Im MDN-Beispiel wird ein Kind mit z-index 6 genau aus diesem Grund unter einem Element mit 5 gezeichnet.
Ändert opacity das Stapeln in CSS?
Ja. Eine opacity unter 1 erzeugt einen Stacking Context, ebenso transform, filter und isolation: isolate, auch ohne gesetztes z-index.
Was sollte ich nach dem Import einer Seite in Figma zu z-index prüfen?
Betrachten Sie die Reihenfolge im Layers-Panel als Ergebnis der Zeichenreihenfolge der Seite. Prüfen Sie überlappende Elemente wie Sticky-Header, Modals und Dropdowns und lesen Sie den Importbericht für alles, was auf eine Ersatzlösung zurückgefallen ist.