Webdesign mit Design-Tokens systematisch gestalten
Farben, Abstände, Rundungen und Schriftgrössen sollen über alle Komponenten einer Website hinweg zusammenpassen. Numerische Design-Token-Skalen bündeln diese Werte für Gutenberg-Blöcke, responsive Layouts und die zentrale Weiterentwicklung des Designs.
Bei individuellen WordPress-Websites sorgt ein gemeinsames Gestaltungssystem dafür, dass Farben, Typografie, Abstände und Komponenten zusammenwirken. Die zugrunde liegenden Werte bündeln wir in gemeinsam verwendeten Design-Token-Skalen.
Die numerischen Skalen bilden die technische Grundlage für semantische Tokens, responsive Werte und eine abgestimmte Darstellung in Editor und Frontend.
Gestaltungswerte
eindeutig benennen
Design-Tokens geben gestalterischen Entscheidungen eindeutige Namen. Eine Hauptfarbe wird beispielsweise unter folgendem Namen gespeichert:
--ud-color-theme-500: #159985;
Der Name beschreibt drei Ebenen:
--ud-[Kategorie]-[Gruppe]-[Stufe]
color bezeichnet die Kategorie. theme benennt die Farbgruppe und 500 ihre Position innerhalb der Skala. Nach demselben Muster lassen sich weitere Farbgruppen ergänzen:
--ud-color-theme-500;
--ud-color-neutral-300;
--ud-color-success-600;
Die einheitlichen Namen erleichtern die Orientierung im Stylesheet. Gleichzeitig machen sie sichtbar, welche Grundwerte verschiedene Komponenten gemeinsam verwenden.
Eine numerische Skala
von 100 bis 900
Die Nummerierung von 100 bis 900 ist aus etablierten Designsystemen bekannt. Bei Farben steht 100 üblicherweise für den hellsten Ton, 500 für den Basiswert und 900 für den dunkelsten Ton.
:root {
--ud-color-theme-100: #e9eeff;
--ud-color-theme-200: #cfd9ff;
--ud-color-theme-300: #a8baff;
--ud-color-theme-400: #7794ff;
--ud-color-theme-500: #3f63f3;
--ud-color-theme-600: #2f4cd0;
--ud-color-theme-700: #263ca8;
--ud-color-theme-800: #223588;
--ud-color-theme-900: #1e2e6d;
}
Die Zahlen kennzeichnen die Position innerhalb der Skala. Jede Stufe erhält einen passenden konkreten Wert, etwa einen Farbwert oder eine rem-Angabe. So bleibt die Nummerierung über verschiedene Kategorien hinweg einheitlich.

Weitere Gestaltungswerte
nach demselben Prinzip
Dasselbe Nummerierungssystem verwenden wir auch für Abstände, Rundungen und Schriftgrössen. Dadurch lassen sich unterschiedliche Gestaltungswerte über Komponenten und Seitentypen hinweg einheitlich einsetzen.
Abstände
Eine Abstandsskala ordnet Innen- und Aussenabstände. Kleine Werte eignen sich für kompakte Elemente, grössere Werte gliedern Komponenten und Seitenabschnitte.
:root {
--ud-spacing-100: 0.25rem;
--ud-spacing-200: 0.5rem;
--ud-spacing-300: 0.75rem;
--ud-spacing-400: 1rem;
--ud-spacing-500: 1.5rem;
--ud-spacing-600: 2rem;
--ud-spacing-700: 3rem;
--ud-spacing-800: 4rem;
--ud-spacing-900: 6rem;
}
Rundungen
Eine eigene Skala ordnet die Eckenrundungen, die in CSS als Border-Radien bezeichnet werden. Karten, Buttons, Eingabefelder und Medienrahmen greifen dadurch auf dieselbe Formensprache zurück.
:root {
--ud-radius-100: 0.125rem;
--ud-radius-200: 0.25rem;
--ud-radius-300: 0.375rem;
--ud-radius-400: 0.5rem;
--ud-radius-500: 0.75rem;
--ud-radius-600: 1rem;
--ud-radius-700: 1.5rem;
--ud-radius-800: 2rem;
--ud-radius-900: 3rem;
}
Spezielle Formen können zusätzlich einen eigenen Namen erhalten:
--ud-radius-round: 999px;
Schriftgrössen
Eine typografische Skala weist Zusatzinformationen, Fliesstexten, Einleitungen und Überschriften passende Schriftgrössen zu. Responsive Werte lassen sich direkt in den Tokens hinterlegen.
:root {
--ud-font-size-100: 0.75rem;
--ud-font-size-200: 0.875rem;
--ud-font-size-300: 1rem;
--ud-font-size-400: 1.25rem;
--ud-font-size-500: 1.5rem;
--ud-font-size-600: clamp(1.75rem, 3vw, 2rem);
--ud-font-size-700: clamp(2rem, 4vw, 2.75rem);
--ud-font-size-800: clamp(2.75rem, 5vw, 4rem);
--ud-font-size-900: clamp(3.5rem, 7vw, 6rem);
}
clamp() verbindet eine minimale, eine flexible und eine maximale Schriftgrösse. Der Text skaliert dadurch fliessend mit der verfügbaren Breite und bleibt innerhalb der festgelegten Grenzen.

Basiswerte
und semantische Tokens
Die numerischen Skalen bilden die gestalterische Basis. Solche Grundwerte werden in der Fachsprache als Primitive Tokens bezeichnet. Semantische Tokens ordnen ihnen anschliessend konkrete Aufgaben im Interface zu.
:root {
--ud-color-primary: var(--ud-color-theme-500);
--ud-color-primary-hover: var(--ud-color-theme-700);
--ud-color-surface-soft: var(--ud-color-theme-100);
--ud-spacing-component: var(--ud-spacing-500);
--ud-spacing-section: var(--ud-spacing-800);
--ud-radius-control: var(--ud-radius-300);
--ud-radius-card: var(--ud-radius-600);
--ud-font-size-body: var(--ud-font-size-300);
--ud-font-size-lead: var(--ud-font-size-400);
--ud-font-size-heading: var(--ud-font-size-700);
}
Bezeichnungen wie primary, surface, card oder heading zeigen, wofür ein Wert eingesetzt wird. Die semantischen Tokens verbinden dadurch die gestalterischen Grundwerte mit konkreten Bestandteilen der Website.
Eine Karte verwendet dadurch Werte, deren Aufgabe unmittelbar erkennbar ist:
.ud-card {
padding: var(--ud-spacing-component);
border-radius: var(--ud-radius-card);
background: var(--ud-color-surface-soft);
}
.ud-card__title {
color: var(--ud-color-primary);
font-size: var(--ud-font-size-heading);
}

Gemeinsame Werte
für Editor und Frontend
Bei individuellen Gutenberg-Blöcken binden wir die Design-Tokens in die redaktionelle Oberfläche und die Ausgabe auf der Website ein.
Editor und Frontend greifen dadurch auf dieselben Farben, Abstände, Rundungen und Schriftgrössen zurück. Die Redaktion erhält während der Bearbeitung eine aussagekräftige Vorschau der späteren Darstellung.
Ein Block kann seine Werte direkt aus dem gemeinsamen System beziehen:
.wp-block-ud-example {
display: grid;
gap: var(--ud-spacing-500);
padding: var(--ud-spacing-700);
border-radius: var(--ud-radius-600);
background: var(--ud-color-theme-100);
}
.wp-block-ud-example h2 {
margin-block: 0 var(--ud-spacing-300);
color: var(--ud-color-theme-800);
font-size: var(--ud-font-size-700);
}
Jeder Block erhält eine auf seinen Inhalt abgestimmte Gestaltung und verwendet zugleich die gemeinsamen Farben, Abstände, Rundungen und Schriftgrössen.
Responsive Gestaltung
zentral definieren
Responsive Werte lassen sich direkt in Design-Tokens hinterlegen. Bei Schriftgrössen, Abständen und Seitenrändern entsteht dadurch eine fliessende Skalierung zwischen kleinen und grossen Ansichten.
:root {
--ud-spacing-page: clamp(1rem, 4vw, 4rem);
--ud-spacing-section: clamp(3rem, 8vw, 8rem);
--ud-font-size-heading: clamp(2rem, 4vw, 3.5rem);
}
Komponenten verwenden anschliessend lediglich den semantischen Namen:
.ud-section {
padding-inline: var(--ud-spacing-page);
padding-block: var(--ud-spacing-section);
}
.ud-section__title {
font-size: var(--ud-font-size-heading);
}
Das responsive Verhalten wird einmal zentral definiert. Anschliessend können alle passenden Komponenten dieselben Werte verwenden.
Das Design
zentral weiterentwickeln
Ein Design-Token-System unterstützt die kontinuierliche Weiterentwicklung einer Website. Eine neue Hauptfarbe, grosszügigere Seitenabstände oder stärker gerundete Karten lassen sich über die zugrunde liegenden Werte steuern.
Semantische Tokens halten dabei die Bedeutung stabil. --ud-color-primary bezeichnet weiterhin die primäre Farbe, auch wenn ihr konkreter Farbwert künftig aus einer anderen Stufe oder Farbgruppe stammt.
Das System eignet sich besonders für individuelle WordPress-Websites mit mehreren eigenen Gutenberg-Blöcken. Neue Komponenten verwenden die vorhandenen Skalen und fügen sich dadurch von Beginn an in die bestehende Gestaltung ein.
Ergebnis
Ein System für alle Gestaltungswerte
Design-Tokens verbinden gestalterische Entscheidungen mit einer klaren technischen Struktur. In unseren individuellen WordPress-Lösungen entsteht daraus ein erweiterbares System, das Gutenberg-Blöcke sowie die Darstellung in Editor und Frontend aufeinander abstimmt.
Systematisch geordnet
Numerische Skalen strukturieren Farben, Abstände, Rundungen und Schriftgrössen.
Die einheitlichen Stufen erleichtern die Orientierung im gesamten Designsystem.
Durchgängig eingesetzt
Semantische Tokens verbinden die Grundwerte mit konkreten Aufgaben. Gutenberg-Blöcke verwenden dadurch in Editor und Frontend dieselben gestalterischen Grundlagen.
Zentral weiterentwickelbar
Responsive Werte und gestalterische Anpassungen werden zentral definiert.
Alle zugeordneten Komponenten verwenden anschliessend die aktualisierten Werte.

