Design-Tokens: Überblick
Design-Tokens sind die Bausteine aller UI-Elemente. Dieselben Tokens werden in Design, Tools und Code verwendet.
- Tokens verweisen auf Stilwerte wie Farben, Schriftarten und Maße
- Verwenden Sie Design-Tokens anstelle von hartcodierten Werten
- Jedes Token ist nach seiner Funktion oder seinem Verwendungsort benannt (zum Beispiel legt md.comp.fab.primary.container.color die Containerfarbe einer FAB fest)
- Selbst wenn der Endwert eines Tokens geändert wird, bleiben Name und Verwendung des Tokens unverändert
- Material Design umfasst drei Klassen von Tokens: Referenz-Tokens, System-Tokens und Komponenten-Tokens

Ressourcen
| Typ | Link | Status |
|---|---|---|
| Design | Design Kit (Figma) | Verfügbar |
| Material Theme Builder Figma-Plugin | Verfügbar | |
| Implementierung | Material-Baseline-Theme und -Tokens (DSP) | Verfügbar |
Was ist ein Design-Token?
Design-Tokens sind kleine, wiederverwendbare Designentscheidungen, die den visuellen Stil eines Designsystems ausmachen. Tokens ersetzen statische Werte durch selbsterklärende Namen.
Ein Design-Token besteht aus zwei Bestandteilen:
- Ein Name in Code-Schreibweise, z. B. md.ref.palette.secondary90
- Ein zugehöriger Wert, z. B. #E8DEF8
Der Wert eines Tokens kann verschiedene Formen annehmen: eine Farbe, eine Schriftart, ein Maß oder sogar ein weiteres Token.

Design-Tokens verknüpfen Stilentscheidungen, die sonst in keiner eindeutigen Beziehung zueinander stünden.
Wenn Mock-up und Implementierung auf dasselbe Token für die „sekundäre Containerfarbe“ verweisen, ist sichergestellt, dass beide dieselbe Farbe verwenden – auch wenn der dem Token zugewiesene Hex-Wert aktualisiert wird.

Warum sind Tokens wichtig?
Tokens geben einem Designsystem eine zentrale, verbindliche Referenz (Single Source of Truth) – ein Repository, in dem Stilentscheidungen dokumentiert und Änderungen nachverfolgt werden können.
Da Tokens wiederverwendbar und zweckgebunden sind, ermöglichen sie systemweite Aktualisierungen von Themes und Kontexten. Beispielsweise können Sie mit Tokens systematisch eine kontrastreichere Farbpalette für bessere Sichtbarkeit anwenden oder die Typografie-Skala ändern, damit Text auf einem Fernsehgerät lesbar ist.
Werden Tokens in Design und Implementierung verwendet, lassen sich Stilaktualisierungen konsistent auf ein gesamtes Produkt oder eine Produktreihe anwenden. Außerdem helfen sie Designern und Entwicklern, „dieselbe Sprache zu sprechen“, und reduzieren Missverständnisse bei der Übergabe von Design an die Implementierung.

Entscheiden, ob Tokens für Sie geeignet sind
Tokens bieten den größten Nutzen, wenn:
- Sie planen, das Design Ihres Produkts zu aktualisieren oder ein Produkt von Grund auf neu zu entwickeln
- Ihr Designsystem über eine Produktreihe oder mehrere Plattformen hinweg angewendet wird
- Sie Stile künftig einfach pflegen oder aktualisieren möchten
- Sie das Material-Design-System optimal nutzen möchten, einschließlich Funktionen wie Dynamic Color
Tokens sind weniger sinnvoll, wenn:
- Sie eine bestehende App mit hartcodierten Werten haben und sich deren Design in den nächsten ein bis zwei Jahren voraussichtlich nicht ändern wird
- Ihr Produkt über kein Designsystem verfügt
Tokens & Material Design
Material-Stile wurden bisher über Richtlinien, Designdateien, Tools und plattformspezifische Komponentenbibliotheken kommuniziert.
Mit Design-Tokens können Sie Material-Stile jetzt herunterladen, anpassen und anwenden und sie in Ihren Design- und Entwicklungsprozess integrieren.
Tokens ermöglichen es, Designentscheidungen in einem plattformunabhängigen, teilbaren Format zu dokumentieren.

Auf dieser Website finden Sie Tokens in interaktiven Modulen.
Mit diesen Modulen können Sie den in Tokens gespeicherten Basiswert für Farbe, Schriftart, Schriftgröße, Schriftstärke usw. schnell nachschlagen. Sie zeigen außerdem die Beziehung zwischen einer Rolle, ihrem System-Token, ihrem Referenz-Token und dem gespeicherten Standardwert.

Sie finden Tokens außerdem in den Specs-Tabs (Spezifikationen) der Komponentenartikel.
Tokens werden zunächst nach Zustand (aktiviert, deaktiviert, Hover usw.) und dann nach Element gruppiert. Das Element ist der Teil der Komponente, auf den ein Token oder Wert angewendet wird, etwa der Container oder der Beschriftungstext.
Die Spalten umfassen:
- Name – Die Eigenschaft des Komponentenstils, auf die das Token angewendet wird, z. B. Farbe oder Schrift
- Token ID – Das Token, das die Eigenschaft des Komponentenstils definiert
- Beschreibung – Optionale Zusatzinformationen
- Kontext/Wert – Der für einen bestimmten Kontext im Token gespeicherte Wert

So verwenden Sie Token-Module
Angenommen, Sie müssen die Farbrolle für den Beschriftungstext eines Filled Schaltfläche überprüfen.
Navigieren Sie zu Common buttons > Spezifikationen, öffnen Sie das Token-Modul für Filled Schaltflächen und suchen Sie unter „Element“ nach den Tokens für den Beschriftungstext („label text“).
Kopieren Sie das Farb-Token und fügen Sie es in den Code ein, oder vergleichen Sie es mit der Farbrolle in Figma.

Bestandteile eines Token-Namens
Die Bestandteile eines Token-Namens sind durch Punkte getrennt und reichen vom allgemeinsten Teil („md“) bis zum spezifischsten Teil („on-secondary“).
- Alle Token-Namen in einem Designsystem beginnen mit dem Systemnamen (z. B. „md“ für Material Design)
- Der zweite Bestandteil ist eine Abkürzung für die Token-Klasse: „ref“ für Referenz-Tokens, „sys“ für System-Tokens und „comp“ für Komponenten-Tokens
- Der restliche Name besteht aus beschreibenden Wörtern, die die Rolle des Tokens angeben

- Gibt das Designsystem an
- Bezeichnet die Token-Klasse
- Gibt den Zweck des Tokens an
Klassen von Tokens
In Material gibt es drei Klassen von Tokens:
- Referenz-Tokens
Alle verfügbaren Tokens mit den zugehörigen Werten. - System-Tokens
Entscheidungen und Rollen, die dem Designsystem seinen Charakter verleihen – von Farbe und Typografie bis hin zu Elevation und Form. - Komponenten-Tokens
Die Designeigenschaften, die Elementen in einer Komponente zugewiesen sind, z. B. die Symbolfarbe einer Schaltfläche.
Mit drei Klassen von Tokens können Teams Designentscheidungen global aktualisieren oder eine Änderung an einer einzelnen Komponente vornehmen.

Referenz-Tokens
Diese Tokens umfassen alle Stiloptionen, die in einem Designsystem verfügbar sind.
Sie verweisen in der Regel auf einen statischen Wert – etwa einen Hex-Farbcode oder eine Schriftgröße –, können aber auch auf andere Referenz-Tokens verweisen. Referenz-Tokens sind nicht kontextabhängig.
Indem sie eine Auswahl bereitstellen, geben Referenz-Tokens Ihrem Team einen Ausgangspunkt mit definierten Farben, Typografie, Maßen usw.
Alle Referenz-Tokens beginnen mit dem Präfix ref.

System-Tokens
System-Tokens sind die Entscheidungen, die die Designsprache für ein bestimmtes Theme oder einen bestimmten Kontext festlegen.
System-Tokens definieren den Zweck, den ein Referenz-Token in der UI erfüllt.
Hier findet das Theming statt. Das System-Token kann je nach Kontext – etwa in einem hellen oder dunklen Theme – auf unterschiedliche Referenz-Tokens verweisen.
System-Tokens sollten nach Möglichkeit auf Referenz-Tokens statt auf statische Werte verweisen.
Alle System-Tokens beginnen mit dem Präfix sys.

Komponenten-Tokens (in Entwicklung)
Komponenten-Tokens repräsentieren die Elemente, die zum Zusammensetzen einer Komponente erforderlich sind, etwa Container, Beschriftungstext, Symbole, Zustände (States) und deren Werte wie Größe, Form, Farbe oder Elevation.
Komponenten-Tokens sollten nach Möglichkeit auf ein System- oder Referenz-Token verweisen und keine hartcodierten Werte wie Hex-Codes enthalten.
Nicht jede Stilentscheidung einer Komponente lässt sich als Token abbilden. Wenn eine Designentscheidung jedoch für mehrere Komponenten mit ähnlichem Zweck gilt, sollte ein Token verwendet werden.
Alle Komponenten-Tokens beginnen mit dem Präfix comp.

Kontexte
Tokens können abhängig von bestimmten Bedingungen auf unterschiedliche Werte verweisen. Diese Bedingungen heißen Kontexte; die daraus resultierenden Werte heißen kontextabhängige Werte.
Beispiele für unterschiedliche Kontexte sind Geräteformfaktoren, ein dunkles Theme, kompakte Layouts und von rechts nach links geschriebene Schriftsysteme.
Sie können sich einen Kontext als Tag vorstellen. Ist ein Token-Wert mit dem Tag „Dark Theme“ markiert, überschreibt er den Standardwert des Tokens, wenn das dunkle Theme aktiv ist.
