CSS-Masken und clip-path in Figma: Unterstützung und Fallbacks beim Import
Wie CSS clip-path und mask auf Figmas Vektor-, Alpha- und Luminanzmasken abgebildet werden, wie der Browser-Support 2026 aussieht und welche Fallbacks noch zählen.
Ein clip-path in CSS ist ein Schnitt mit harter Kante, und eine CSS-Maske ist ein Filter über Alpha oder Luminanz. In Figma entspricht dem clip-path am ehesten eine Vektormaske, und der CSS-Maske am ehesten eine Alpha- oder Luminanzmaske. Der Browser-Support ist nicht mehr das Problem: Beide Eigenschaften sind Baseline und weit verfügbar. Aufmerksamkeit brauchen nach dem Import einer Seite in Figma vor allem der Wirkungsbereich der Maske und die Stapelreihenfolge.
Unten stehen die beiden CSS-Eigenschaften neben den drei Maskentypen von Figma. Dazu kommen der aktuelle Browser-Support mit Stand 2026-11-15 und die Fallbacks, die sich weiterhin lohnen. UnHTML zielt auf originalgetreue, bearbeitbare Ebenen, nicht auf einen pixelgenauen Klon, und der Importbericht listet auf, was auf einen Fallback ausweichen musste. Dieser Artikel behauptet nichts darüber, wie UnHTML eine bestimmte Maske umwandelt. Verstehe die Zuordnung unten als Lesehilfe, die aus der CSS- und der Figma-Dokumentation entstanden ist.
clip-path und mask in CSS
clip-path: ein Bereich mit harter Kante
MDN beschreibt clip-path als Erzeugung eines Beschnittbereichs, der festlegt, welcher Teil eines Elements sichtbar ist. Was innerhalb des Bereichs liegt, wird gezeigt, was außerhalb liegt, wird ausgeblendet. An der Kante gibt es keine Teiltransparenz.
Der Bereich stammt aus einer von drei Wertarten:
- Ein
url(), das auf ein SVG-Element<clipPath>zeigt. - Eine Basisform:
inset(),circle(),ellipse(),polygon(),path(),rect(),shape()oderxywh(). - Eine Geometriebox wie
padding-boxodercontent-box, allein oder zusammen mit einer Form.
Gibst du keine Geometriebox an, ist die Referenzbox border-box, und Prozentwerte beziehen sich auf diese Referenzbox. Zwei Details zählen, wenn du eine importierte Seite liest. Ein path() skaliert nicht mit seinem Element, während shape() Prozentwerte und benutzerdefinierte Eigenschaften akzeptiert, was MDN als robuster bezeichnet. Außerdem erzeugt jeder Wert außer none einen neuen Stapelkontext, genau wie opacity unter 1.
mask: Alpha oder Luminanz eines Bildes
Die Kurzschreibweise mask blendet ein Element ganz oder teilweise mithilfe einer Maskenebene aus. Sie ist die Kurzform der mask-*-Eigenschaften. Eine Ebene kann ein url(), ein Verlauf oder eine andere Bildquelle sein, und weggelassene Teile fallen auf ihre Anfangswerte zurück: mask-mode: match-source, mask-size: auto, mask-repeat: repeat, mask-clip: border-box und mask-composite: add.
mask-mode akzeptiert alpha, luminance oder match-source. Bei der Alpha-Maskierung machen opake Bereiche der Maske das Element sichtbar, transparente blenden es aus. Bei der Luminanzmaskierung machen helle, opake Bereiche es sichtbar, dunkle oder transparente blenden es aus. mask-composite bestimmt, wie mehrere Ebenen kombiniert werden: add, subtract, intersect oder exclude.
Ist die Maskenquelle eine SVG-Datei, sind die darin enthaltenen Formen echte Vektordaten. Wie SVG auf einer Seite zu nativen Figma-Vektoren wird behandelt diese Seite.
Wie Masken und Beschnitte zu Figma passen
Die drei Maskentypen von Figma
Figmas Artikel zu Masken nennt drei Typen. Jede Ebene kann als Maske dienen. Du legst sie hinter die Ebenen, die sie maskiert, und wählst dann More options > Use as mask.
- Alpha ist der Standard. Die Maske wirkt über ihre Deckkraft, sodass Weichzeichner, Schatten und halbtransparente Konturen das Ergebnis verändern.
- Vector ignoriert Transparenz. Figma behandelt die Maske als vollständig deckend, und hat ein Bereich eine Deckkraft über null Prozent, werden seine Umrisse zur Maske.
- Luminance nutzt die Helligkeit. Je heller der Bereich, desto mehr wird sichtbar, und eine schwarze Maske
#000000zeigt nichts.
Tabelle: Eigenschaft zu Maske
| CSS | Nächste Figma-Maske | Was zu prüfen ist |
|---|---|---|
clip-path mit Basisform oder url() | Vector | Nur der Umriss, daher sind die Kanten in beiden hart |
mask-mode: alpha | Alpha | Die Transparenz von Verlauf oder Bild bestimmt, was sichtbar wird |
mask-mode: luminance | Luminance | Dunkle Bereiche blenden aus, helle machen sichtbar |
mask-composite mit mehreren Ebenen | Keine einzelne Einstellung in der Dokumentation | Von Hand nachbauen, wenn sich Ebenen kombinieren |
Die letzte Zeile ist die ehrliche Lücke. Keine der beiden Quellen beschreibt eine Figma-Einstellung für subtract, intersect oder exclude, deshalb kann eine gestapelte Maske auf der Live-Seite Handarbeit erfordern.
Regeln zum Wirkungsbereich
Eine Figma-Maske wirkt auf die Geschwisterebenen über ihr. Sie endet an einer anderen Maske, am übergeordneten Frame oder an der übergeordneten Gruppe der Maske sowie an einem Frame oder einer Komponente mit aktiviertem Clip content. Eine Maske ist Geschwister dessen, was sie maskiert, nicht dessen Elternteil, daher verschiebt das Bewegen oder Skalieren der einen nicht die andere. Scheint eine importierte Maske eine Ebene zu verfehlen, prüfe zuerst Reihenfolge und Verschachtelung. CSS overflow und Figmas Clip content erklärt den anderen Beschnittmechanismus, der stören kann.
Browser-Support heute
Mit Stand 2026-11-15 kennzeichnet MDN clip-path als Baseline, weit verfügbar, in allen großen Browsern seit Januar 2020. Die Kurzschreibweise mask ohne Präfix kennzeichnet MDN als weit verfügbar seit Dezember 2023, mit dem Hinweis, dass einzelne Teile abweichen können.
Die Tabelle zu CSS-Masken bei Can I use nennt eine globale Unterstützung von rund 97,4 Prozent: 94,42 Prozent vollständig plus 2,98 Prozent teilweise. Chrome und Edge unterstützen sie vollständig ab Version 120, Safari ab 15.4 und Firefox ab 53. Frühere Versionen sind als teilweise markiert, und die Seite erklärt nicht, was jeweils fehlt. Opera Mini unterstützt sie in keiner Version.
Für einen Design-Import heißt das: Die Seite, die du erfasst hast, hat ihre Masken im verwendeten Browser sehr wahrscheinlich wie gedacht gezeichnet. Guter Support ist ein Grund, der Erfassung zu vertrauen. Er ist kein Grund, die Prüfung danach zu überspringen.
Fallbacks, die weiterhin zählen
- Neuere clip-path-Werte.
shape()undxywh()sind neue Funktionen. Prüfe die Kompatibilitätstabelle von MDN, bevor du dich darauf verlässt. Sie in eine@supports-Regel zu fassen, ist gängige Praxis, auch wenn keine der oben genannten Quellen es vorschreibt. - Halte die unbeschnittene Fassung lesbar. Ein Beschnitt blendet nur aus. Fällt er weg, sollten Text und Bild trotzdem Sinn ergeben.
- Achte auf den Stapelkontext. Weil ein clip-path außer
noneeinen erzeugt, kann ein beschnittenes Element verändern, welche Ebene oben liegt. Stapelkontexte und Ebenenreihenfolge in Figma geht diese Zuordnung durch. - Bevorzuge
shape()bei Elementen, die ihre Größe ändern. Einpath()behält seine festen Koordinaten, wenn sich die Größe des Elements ändert.
Ein Lesebeispiel
Angenommen, ein Hero-Bild nutzt clip-path: polygon(50% 0%, 100% 50%, 50% 100%, 0% 50%). Das ist eine Raute. An der Kante passiert nichts Teilweises: Pixel liegen entweder in der Raute oder sind weg. In Figma erwartest du eine Vektorform unter dem Bild in derselben Gruppe, mit Use as mask, wobei der Typ auf vector oder alpha steht. Beide ergeben eine harte Kante, wenn die Form eine einfarbige Füllung hat.
Nun nutzt eine Karte mask-image: linear-gradient(black, transparent), um ihre untere Kante auslaufen zu lassen. Die Kante ist weich, eine Vektormaske wäre also falsch: Sie würde jede Deckkraft über null als vollständig deckend behandeln. Der Typ alpha bewahrt den Verlauf, weil das Sichtbare der Deckkraft folgt. Liefe der Verlauf von Weiß nach Schwarz und das CSS setzte mask-mode: luminance, wäre der Typ luminance die richtige Wahl.
Zwei Prüfungen klären die meisten Zweifel. Erstens: Wirkt die Kante auf der Live-Seite hart oder weich? Hart deutet auf eine Vektormaske, weich auf alpha oder luminance. Zweitens: Liegt die Maske in der Ebenenliste über oder unter den Ebenen, die sie betreffen soll? Da eine Figma-Maske nur die Geschwisterebenen über ihr erreicht, kann eine falsch platzierte Maske aussehen, als hätte sie nichts bewirkt.
Das importierte Ergebnis in Figma prüfen
Schalte View > Mask outlines ein, dann umrandet Figma jede Maske grün. Vergleiche den Typ jeder Maske mit dem, was das CSS beabsichtigte, und achte darauf, ob die Kante hart oder weich ist. Danach vergleichst du den Frame mit der Live-Seite bei gleicher Breite.
Maskieren in Figma ist nicht destruktiv: Kein Teil der maskierten Ebenen wird verändert oder gelöscht, und wird eine Maske entfernt, erscheinen verdeckte Bereiche wieder. Eine falsche Maske ist daher günstig zu korrigieren. Rechne damit, dass manche Masken, vor allem gestapelte mask-composite-Ebenen, manuell neu aufgebaut werden müssen. Importierst du eine Seite zum ersten Mal, listet UnHTML diese Fallbacks in seinem Importbericht auf, damit du weißt, wo du hinsehen musst.
Fazit
Behandle clip-path wie eine Vektormaske und mask wie eine Alpha- oder Luminanzmaske, und prüfe in Figma Wirkungsbereich und Reihenfolge jeder einzelnen. Der Browser-Support ist für beide Eigenschaften geklärt, daher lohnen sich Prüfungen von Maskentyp, Geschwisterreihenfolge und Stapelung. Wer diese drei Punkte nach jedem Import kurz durchgeht, findet fehlerhafte Masken meist in wenigen Minuten und muss die Ebenen nicht Stück für Stück nachbauen.