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

VeröffentlichtToolCSS-Variablen Extrahierer

Inhalt
  1. Warum CSS-Variablen an vielen Stellen verstreut sind
  2. So finden Sie Variablen ohne Tool
  3. Häufig missverstandene Matching-Regeln
  4. Zusammenfassung
  5. Häufig gestellte Fragen

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: wert im 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, sondern var(--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.

CSS-Variablen Extrahierer

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.

SituationErgebnisGrund
Der Wert wird vor dem Semikolon umgebrochenNur die erste Zeile wird extrahiertDer reguläre Ausdruck beendet das Matching des Werts am Zeilenumbruch
Im Wert (z. B. in einem String) steht ein SemikolonNur der Teil vor dem Semikolon wird extrahiertDas Semikolon wird als Ende des Werts gewertet
Der Text --name: wert; steht in einem KommentarWird unverändert extrahiertEs wird der gesamte Text durchsucht, ohne Kommentare zu unterscheiden
Derselbe Name ist z. B. in :root und .dark doppelt deklariertWird jeweils als eigene Zeile angezeigtDas Matching erfolgt der Reihe nach, ohne Selektoren zu unterscheiden
Nur eine Referenz an der Wertstelle, z. B. var(--name)Wird nicht extrahiertNur 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: wert erkannt 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.
CSS-Variablen Extrahierer

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

Ähnliche Artikel

  1. Markdown-Links extrahieren: Hyperlinks und Bildlinks als TabelleSo erkennt ein regulärer Ausdruck Links und Bilder in Markdown, welche Fälle er übersieht und wie Sie Tabelle, URL-Liste und JSON-Ergebnis richtig lesen.
  2. URLs in Links umwandeln: So erkennt der Regex AdressenErfahren Sie, wie ein regulärer Ausdruck http- und https-Adressen im Text findet und in a-Tags umwandelt, und wie target, rel, Kürzung und class wirken.
  3. Datei-Prüfsumme vergleichen: Integrität per Hash prüfenSo prüfen Sie mit MD5, SHA-1 und SHA-256, ob eine heruntergeladene Datei dem Original entspricht: Ablauf, Vergleich mit der offiziellen Prüfsumme, häufige Fehler.
  4. font-display swap: Unterschiede der Werte im TabellenvergleichWie unterscheiden sich auto, block, swap, fallback und optional bei Block- und Swap-Period? Tabelle, Timeline und die Bedeutung von „unendlich“ (∞) erklärt.
  5. @font-face CSS schreiben: src-Reihenfolge mit WOFF2, WOFF, TTFSo binden Sie WOFF2, WOFF und TTF per @font-face ein: Reihenfolge in src, Anführungszeichen bei font-family und font-display: swap erklärt.
  6. Standort: Breiten- und Längengrad ermitteln, inkl. GenauigkeitSo ermittelt der Browser Ihren Standort per Geolocation API und das bedeuten die Werte accuracy, altitude und speed in den Koordinaten-Ergebnissen.

Passende Tools