CSS-Variablen extrahieren: Alle --var-Deklarationen auflisten

Inhalt
Wenn benutzerdefinierte CSS-Eigenschaften (Custom Properties) mit dem Präfix -- in einer langen CSS-Datei an vielen Stellen deklariert sind, etwa in :root, in einzelnen Klassen oder in Media Queries, lassen sie sich von Hand kaum noch vollständig finden.
In diesem Beitrag erfahren Sie, wie ein auf regulären Ausdrücken basierender Extrahierer alle --variable-Deklarationen unabhängig von ihrem Fundort in einer einzigen Tabelle sammelt. Außerdem zeige ich, wie Sie die Tabelle nach Name oder Wert durchsuchen und eine Variable direkt im Format var(--name) kopieren. Auch die Matching-Regeln, die oft für Verwirrung sorgen, etwa wenn ein Wert mittendrin abgeschnitten erscheint, werden behandelt.
Zusammenfassung ① Der reguläre Ausdruck sucht das Muster
--name: wertim gesamten Text, egal ob in:root, in Klassen oder in Media Queries, und sammelt die Treffer in einer Tabelle. ② Wenn Sie einen Namen oder einen Teil des Werts in das Suchfeld eingeben, wird die Liste in Echtzeit eingegrenzt. ③ Ein Klick auf den Kopieren-Button legt nicht den Wert, sondernvar(--name)in die Zwischenablage, sodass Sie es direkt einfügen können.
Warum CSS-Variablen an vielen Stellen verstreut sind
CSS Custom Properties werden selten an nur einer Stelle deklariert. Üblich ist, die Standardwerte in :root abzulegen, Überschreibungen für den Dark Mode in einem Selektor wie .dark oder [data-theme="dark"] und Werte, die sich nur bei bestimmten Bildschirmgrößen ändern, in einer @media-Abfrage.
Kommen noch lokale Variablen auf Komponentenebene hinzu, verteilen sich die Deklarationen selbst innerhalb einer einzigen Datei über viele Stellen.
Wollen Sie nun wissen, wie viele Variablen es in einem Projekt gibt oder ob derselbe Name doppelt deklariert wurde, müssen Sie die gesamte Datei durchscrollen und jede Zeile suchen, die mit -- beginnt. Hat die Datei mehrere hundert Zeilen oder ist der Code auf mehrere CSS-Dateien verteilt, übersieht man schnell die eine oder andere Variable.
So finden Sie Variablen ohne Tool
Die Syntax von CSS Custom Properties ist festgelegt. Deshalb können Sie die Variablen auch ohne Tool nach denselben Regeln selbst aufspüren. Das Grundmuster: Auf --name folgt ein Doppelpunkt (:), danach der Wert, und dieser endet, sobald ein Semikolon (;) oder eine geschweifte Klammer (}) folgt.
Suche im Code-Editor und im Terminal
Aktivieren Sie in der Suchfunktion Ihres Code-Editors den Regex-Modus und suchen Sie nach --[a-zA-Z0-9-]+\s*:. Dann werden alle Zeilen mit einer Variablendeklaration in der Datei hervorgehoben. Im Terminal lassen sich Name und Wert mit folgendem Befehl in einem Schritt herausziehen:
grep -oE -- '--[a-zA-Z0-9_-]+ *: *[^;{}]+' style.css
Dieses Vorgehen unterscheidet nicht, ob der Selektor :root oder .dark lautet oder ob die Deklaration in einer Media Query steht. Es durchsucht den gesamten Dateitext nur nach dem Muster --name: wert. Das ist dasselbe Prinzip wie bei den Regeln, die unser Tool verwendet.
Prüfen in den Entwicklertools des Browsers
Möchten Sie in den Entwicklertools des Browsers den tatsächlich angewendeten Wert sehen, wählen Sie im Elements-Panel das Element :root aus und suchen im Reiter „Computed" nach --. Dabei sehen Sie aber nur den berechneten Endwert. In welchem Selektor des Quellcodes die Variable deklariert war, erfahren Sie so nicht.
Bei CSS-Dateien mit Dutzenden oder Hunderten Zeilen ist es schneller, alles auf einmal in einer Tabelle zu sehen, statt diese Arbeit jedes Mal von Hand zu wiederholen. Mit unserem Tool, dem CSS-Variablen Extrahierer, prüfen Sie das direkt.
Der CSS-Variablen Extrahierer findet alle --Variablen-Deklarationen im eingefügten CSS, listet sie in einer Tabelle und kopiert Werte direkt im Format var(--name).

Häufig missverstandene Matching-Regeln
Der reguläre Ausdruck erkennt nur Muster als Deklaration, bei denen direkt auf --name ein Doppelpunkt folgt. Der Wert endet sofort bei einem Semikolon, einer geschweiften Klammer oder einem Zeilenumbruch. Wegen dieser Regel werden Variablen in bestimmten Situationen gar nicht erfasst oder ihre Werte erscheinen abgeschnitten.
| Situation | Ergebnis | Grund |
|---|---|---|
| Der Wert wird vor dem Semikolon umgebrochen | Nur die erste Zeile wird extrahiert | Der reguläre Ausdruck beendet das Matching des Werts am Zeilenumbruch |
| Im Wert (z. B. in einem String) steht ein Semikolon | Nur der Teil vor dem Semikolon wird extrahiert | Das Semikolon wird als Ende des Werts gewertet |
Der Text --name: wert; steht in einem Kommentar | Wird unverändert extrahiert | Es wird der gesamte Text durchsucht, ohne Kommentare zu unterscheiden |
Derselbe Name ist z. B. in :root und .dark doppelt deklariert | Wird jeweils als eigene Zeile angezeigt | Das Matching erfolgt der Reihe nach, ohne Selektoren zu unterscheiden |
Nur eine Referenz an der Wertstelle, z. B. var(--name) | Wird nicht extrahiert | Nur ein Name mit folgendem Doppelpunkt gilt als Deklaration |
Besonders Semikolons in String-Werten und Deklarationen in Kommentaren sind in der Praxis häufige Stolpersteine. Weicht das Ergebnis von Ihrer Erwartung ab, prüfen Sie am besten zuerst, ob im Original-CSS rund um die Variable ein Semikolon oder ein Kommentar steht.
Zusammenfassung
- CSS Custom Properties werden unabhängig vom Deklarationsort (
:root, Klassen, Media Queries usw.) ausschließlich über das Muster--name: werterkannt und extrahiert. - Ein Wert endet bei einem Semikolon, einer geschweiften Klammer oder einem Zeilenumbruch. Erstreckt sich ein Wert über mehrere Zeilen oder enthält er ein Semikolon, kann er daher abgeschnitten erscheinen.
- Auch Deklarationen in Kommentaren werden als Text erkannt und unverändert extrahiert. Wird derselbe Name mehrfach deklariert, erscheint jede Deklaration in einer eigenen Zeile.
- Wenn Sie einen Namen oder einen Teil des Werts in das Suchfeld eingeben, wird die Liste in Echtzeit eingegrenzt. Der Kopieren-Button kopiert nicht den Wert, sondern das Format
var(--name). - Mit einem regulären Ausdruck nach demselben Prinzip können Sie auch ohne Tool selbst suchen. Je länger die Datei wird, desto schneller geht es aber mit der Tabellenansicht.
Der CSS-Variablen Extrahierer findet alle --Variablen-Deklarationen im eingefügten CSS, listet sie in einer Tabelle und kopiert Werte direkt im Format var(--name).
Häufig gestellte Fragen
Werden auch Variablen außerhalb von :root extrahiert?
Ja. Der reguläre Ausdruck unterscheidet nicht zwischen Selektoren, sondern sucht im gesamten Text nur nach dem Muster --name: wert. Auch Variablen, die in einem Klassenselektor oder in einer @media-Abfrage deklariert sind, erscheinen genauso in der Tabelle wie die aus :root.
Was muss ich in das Suchfeld eingeben?
Geben Sie einfach einen Variablennamen oder einen Teil des Werts ein. Die Suche unterscheidet nicht zwischen Groß- und Kleinschreibung und filtert in Echtzeit nach Treffern in Name und Wert.
Wird beim Klick auf den Kopieren-Button der Wert kopiert?
Nein. Kopiert wird nicht der ursprüngliche Wert, sondern ein String im Format var(--name). Er ist dafür gedacht, direkt in eine andere CSS-Regel eingefügt zu werden, um die Variable zu referenzieren.
Werden auch $variable aus SCSS oder @variable aus LESS extrahiert?
Nein. Der reguläre Ausdruck sucht ausschließlich nach nativen CSS Custom Properties, die mit -- beginnen. Präprozessor-Variablen, die mit $ oder @ beginnen, werden nicht erfasst.
Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen