Die Dark-Mode-Version einer Seite in Figma importieren

Ein Import erfasst nur ein Theme. Mach das dunkle Theme zum einzigen Zustand der Datei, importiere mit gleicher Breite und koppele beide Frames über Variablenmodi.

TUTORIALDESIGNERVeröffentlicht

So kommt das dunkle Theme nach Figma

Ein Import erfasst nur ein Theme. Um die dunkle Version einer Seite nach Figma zu bringen, sorgst du dafür, dass die gespeicherte Datei nur noch den dunklen Zustand zeigen kann, und importierst sie dann mit derselben Breite wie die helle Version. Anschließend kannst du die beiden Frames mit Variablenmodi in Figma koppeln.

Du brauchst eine Seite mit dunklem Theme, die DevTools in Chrome oder Firefox, das UnHTML-Plugin und, falls du Variablenmodi nutzen willst, einen Figma-Tarif ab Professional. Rechne bei einer typischen Marketingseite mit etwa fünfzehn Minuten.

Warum ein Import nur ein Theme ist

Eine Seite wird so konvertiert, wie sie gerade gerendert wird. Ein Import ist also eine Momentaufnahme eines einzelnen Zustands. Dasselbe gilt für Breakpoints, wie was ein einzelner Import erfasst zeigt: Du erhältst das Layout, das bei der gewählten Breite galt, nicht jeden Zweig des Stylesheets.

Bei Themes ist es genauso. Die öffentlichen Seiten von UnHTML beschreiben die Eingaben (eine eigenständige .html-Datei, ein Safari-.webarchive oder eine scene.json aus der Open-Source-CLI), die Viewport-Auswahl und die lokale Verarbeitung. Sie sagen nicht, dass der Importer prefers-color-scheme emuliert oder das Theme einer Website umschaltet. Deshalb verlässt sich dieser Leitfaden nicht darauf. Du machst die Datei selbst dunkel, und der Importer konvertiert nur, was er bekommt.

Wie eine Seite dunkel wird

Seiten wählen ihr Theme auf eine von drei Arten. Finde heraus, welche deine nutzt.

Die Media Query

Das Media Feature prefers-color-scheme kennt die Werte light und dark und spiegelt eine Einstellung des Betriebssystems oder des Browsers wider. MDN führt es als weit verfügbar in den Browsern seit Januar 2020. Üblich ist ein heller Standard mit einer dunklen Überschreibung:

body {
  background: #ffffff;
  color: #111111;
}

@media (prefers-color-scheme: dark) {
  body {
    background: #121212;
    color: #eeeeee;
  }
}

color-scheme und das Meta-Tag

Die Eigenschaft color-scheme erfüllt eine andere Aufgabe. web.dev erklärt, dass sie die Seite für die eigenen dunklen Standardwerte des Browsers öffnet: Formularelemente, Scrollleisten, Systemfarben und den Hintergrund der Zeichenfläche. prefers-color-scheme steuert dagegen das Erscheinungsbild, das du selbst gestaltest. Seiten mit sauberem Dark-Mode-Support nutzen beides und ergänzen oft <meta name="color-scheme" content="dark light">, damit schon das erste Rendering im richtigen Schema erscheint.

Umschalter per Klasse oder Attribut

Viele Websites liefern einen Theme-Schalter mit. Ein Klick setzt eine Klasse oder ein Data-Attribut auf html oder body, und das Stylesheet richtet sich danach. Eine Media Query ist nicht beteiligt, und die Auswahl steckt oft in localStorage statt in der Datei.

Schritt 1: Herausfinden, welchen Mechanismus die Seite nutzt

  1. Öffne die DevTools und suche in den Stylesheets nach prefers-color-scheme. Taucht es auf, reagiert die Seite auf die Systemeinstellung.
  2. Nutze den Theme-Schalter der Seite, falls vorhanden, und beobachte, wie sich die Attribute class oder data- an html und body ändern.
  3. Emuliere die Einstellung in den DevTools zur Bestätigung. In Chrome hat das Rendering-Panel ein Emulationsfeld für prefers-color-scheme. Firefox bietet entsprechende Schaltflächen im Seiten-Inspektor.

Notiere das Ergebnis: Media Query, Umschalter oder beides. Davon hängt ab, wie du die Datei in Schritt 2 erfasst.

Schritt 2: Den dunklen Zustand als Datei festhalten

Ziel ist eine gespeicherte Datei, die dunkel ist, egal wer sie öffnet. Unsere Anleitung zum Export von eigenständigem HTML aus Chrome behandelt das Speichern selbst. Hier ändert sich, was du davor und danach tust.

Bei einer Seite mit Umschalter wechselst du zuerst im Browser zum dunklen Theme und speicherst dann. Die dunkle Klasse oder das Attribut ist damit Teil des gespeicherten Markups, und das Stylesheet wendet sie jedes Mal an.

Bei einer Seite mit Media Query bearbeitest du die gespeicherte Kopie so, dass die dunklen Werte bedingungslos gelten. Verschiebe die Deklarationen aus dem @media-Block und setze color-scheme passend dazu:

:root {
  color-scheme: dark;
}

body {
  background: #121212;
  color: #eeeeee;
}

Lass die ursprüngliche helle Kopie unangetastet. Du brauchst sie für Schritt 4.

Gleiche Breite verwenden. Importiere beide Themes mit derselben Breite: Desktop 1440, Mobile 390 oder dieselbe benutzerdefinierte Breite. Zwei Importe mit unterschiedlicher Breite lassen sich nicht Ebene für Ebene vergleichen.

Vor dem Import prüfen. Öffne die gespeicherte Datei in einem Browser, dessen System auf hell steht. Ist die Seite dort dunkel, ist sie es auch für den Konverter. Springt sie zurück auf hell, hängt noch eine Regel an der Einstellung oder an einem Skript.

Schritt 3: Importieren und das Ergebnis prüfen

Führe den Import aus und benenne den Frame etwa Home / Dark. Prüfe dann die Stellen, an denen dunkle Themes meist Probleme machen:

  • Text auf dunklen Flächen. Vergleiche einige Überschriften und Textabschnitte mit dem Browser.
  • Linkfarben. Die klassische Linkfarbe des Browsers, rgb(0, 0, 238), hat auf Schwarz ein Kontrastverhältnis von 2.23:1 und verfehlt sowohl WCAG AA als auch AAA. Hat die Seite sie nie überschrieben, wirken Links auch im Import blass. Das liegt dann an der Seite, nicht am Konverter.
  • Bilder mit hellem Hintergrund. Ein Logo, das mit weißem Kasten exportiert wurde, zeigt diesen Kasten auf dunkler Fläche.
  • Formularelemente. Ihr dunkles Aussehen kommt von color-scheme. Prüfe also, ob die gespeicherte Datei diese Deklaration behalten hat.
  • Schriften. Nicht installierte Schriften werden ersetzt (standardmäßig durch Inter), und jeder Austausch steht im Importbericht.

Beachte das Ebenenlimit. Der kostenlose Tarif erlaubt Stand 2026 500 Ebenen pro Import, Pro (39 USD, einmalig pro Editor) hebt das Limit auf. Eine dichte dunkle Seite kann die 500 schneller erreichen, als du erwartest, weil Schatten und Overlays oft zu eigenen Ebenen werden. UnHTML ist kein pixelgenauer Klon. Lass die Live-Seite beim Vergleichen neben dem Frame offen.

Schritt 4: Beide Importe mit Variablenmodi koppeln

Jetzt hast du zwei Frames, hell und dunkel. Du kannst sie zur Durchsicht nebeneinander lassen, oft reicht das. Wenn du einen einzigen Frame willst, der umschaltet, nutze Variablenmodi.

  1. Lege eine Farbvariablen-Collection mit zwei Modi an, Light und Dark. Die erste Spalte ist der Standardmodus.
  2. Befülle sie mit den Farben der Seite. Der Artikel dazu, wie du die Farbstile extrahierst, zeigt, wie du sie sammelst. Eine importierte Seite mit Figma-Variablen responsiv machen erklärt, wie du Variablen an importierte Ebenen bindest.
  3. Binde die Füllungen und Textfarben des hellen Frames an diese Variablen.
  4. Wähle den Frame, öffne den Bereich Appearance in der rechten Seitenleiste, klicke auf Apply variable mode und wähle den Modus Dark der Collection.

Die Figma-Hilfe nennt zwei Bedingungen. Die verschachtelten Ebenen des Frames müssen mindestens eine Variable verwenden, und diese Variable muss mehr als einen Modus haben. Ebenen auf Auto übernehmen den Modus ihres übergeordneten Elements, und setzt kein Elternelement einen, gilt der Standardmodus der Collection. Variablenmodi gibt es ab dem Professional-Tarif, und die Zahl der Modi pro Collection hängt vom Tarif ab.

Was UnHTML bei Themes tut und was nicht

Dokumentiert ist: UnHTML nimmt eine eigenständige .html-Datei, ein Safari-.webarchive oder eine CLI-scene.json entgegen, lässt dich Desktop 1440, Mobile 390 oder eine eigene Breite wählen und stellt standardmäßig keine Netzwerkanfragen. Nicht dokumentiert ist auf den öffentlichen Seiten, ob es Themes umschaltet oder Präferenzen emuliert. Dieser Leitfaden behandelt beides als unbekannt und umgeht es, indem die Datei selbst dunkel gemacht wird.

Zusammenfassung

Mach den dunklen Zustand zum einzigen der Datei, importiere sie mit derselben Breite wie die helle Version und prüfe den Kontrast bei Text und Links. Koppele die Frames danach mit Variablenmodi, wenn du einen einzelnen Frame zum Umschalten willst.

Häufige Fragen

Importiert UnHTML die dunkle Version einer Seite automatisch?

Die öffentlichen Seiten von UnHTML sagen nicht, dass es prefers-color-scheme emuliert oder das Theme einer Website umschaltet, also verlass dich nicht darauf. Es konvertiert die Seite, die es bekommt. Gibst du ihm eine Datei, deren dunkle Stile bedingungslos gelten, kommen die Ebenen dunkel heraus.

Warum ist mein Import hell, obwohl mein Browser im Dark Mode läuft?

Eine gespeicherte Datei behält das CSS der Seite, nicht deine Systemeinstellung. Stehen die dunklen Farben in einer prefers-color-scheme-Media-Query, entscheidet das, was die Datei rendert, welcher Zweig gilt. Bedingungslose dunkle Werte beseitigen diese Abhängigkeit.

Kann Figma einen importierten Frame zwischen hell und dunkel umschalten?

Ja, mit Variablenmodi. Lege eine Collection mit den Modi Light und Dark an, binde die Füllungen an ihre Variablen und nutze Apply variable mode am Frame. Modi setzen einen Tarif ab Professional voraus.

Brauche ich zwei Importe für hell und dunkel?

Für eine getreue Kopie beider Themes ja: ein Import pro Theme mit derselben Breite. Du kannst beide Frames nebeneinander behalten oder einen davon als variablengesteuerten Frame neu aufbauen.