Visuelles Design
Das System unter jedem Bildschirm: Tokens für Farbe, Schrift, Raum, Form, Tiefe und Bewegung sowie die darauf aufbauenden Komponentenspezifikationen. Der designer-Skill wendet dieses System auf echte Seiten an. Bauen Sie das System einmal; lassen Sie Seiten es ausgeben.
Die wichtigsten Regeln
- Schreiben Sie die Designrichtung in Worten, bevor Sie ein Token erstellen. Drei oder vier Sätze: Für wen es ist, wie es sich anfühlen soll, wie es sich niemals anfühlen darf und die eine Sache, die es vom Fachgebiet übernimmt. Jede Token-Entscheidung wird an diesem Absatz gemessen.
- Komponenten referenzieren semantische Tokens, niemals Primitive.
--color-text-primary, nicht--grey-900. Dark Mode, Theming und Rebrandings werden dann zu einer Neuzuordnung, nicht zu einer Neuschreibung. - Überprüfen Sie den Kontrast für jedes reale Paar in beiden Designs anhand der folgenden Tabelle. Eine Palette, die auf Weiß besteht, kann auf ihrer eigenen getönten Oberfläche versagen.
- Ein Standardwert ist keine Entscheidung. Framework-Graustufen, Inter auf allem, ein 4px Radius auf jeder Box: Jedes sieht für sich gut aus, und zusammen sehen sie aus wie jedes andere Produkt. Entscheiden Sie sich für jeden Wert oder akzeptieren Sie ihn bewusst.
- Jede Komponentenspezifikation listet jeden Zustand auf: Standard, Hover, Fokus, Aktiv, Deaktiviert, Laden, Fehler und ggf. Ausgewählt. Fehlende Zustände werden im Build erfunden – und das inkonsistent.
- Weniger Werte, konsistent verwendet. Eine Skala mit 6 Stufen, die überall verwendet wird, ist besser als eine mit 14 Stufen, die zufällig verwendet werden.
Wann nicht zu verwenden
- Anordnung einer bestimmten Seite, Auswahl, was oberhalb der Falz kommt, Kritik an einem Bildschirm oder Durchführung eines Redesigns:
designer. - Erstellen von Illustrationen, Symbolen, Hero-Bildern oder Markenzeichen:
artist. - Diagramme und Datenvisualisierungspaletten: Der
frontend-Skillreferences/charts.md. Kategoriale Diagrammfarben haben andere Einschränkungen als eine Markenpalette. - Implementierung der Tokens in einem Framework:
frontend.
Build-Reihenfolge
Jede Ebene baut auf der vorherigen auf:
- Richtungsabsatz.
- Farbe: Primitive, dann semantische Tokens.
- Typografie: Schriften, dann Skala und Rollen.
- Abstandsskala und Raster.
- Radius, Rahmen und Höhe.
- Bewegungs-Tokens.
- Komponenten-Tokens und Komponentenspezifikationen.
Farbe
Struktur:
Primitive (Rohwerte, eine Rampe pro Farbton, z. B. 50, 100 ... 900, 950):
--blue-600: oklch(0.55 0.17 255)
Semantische Tokens (referenzieren Primitive, benannt nach Funktion):
--color-bg, --color-surface, --color-surface-raised
--color-text, --color-text-muted, --color-text-on-accent
--color-accent, --color-accent-hover
--color-border, --color-focus-ring
--color-danger, --color-success, --color-warning (jeweils mit einer für Text geeigneten Variante)
Regeln, die eine durchdachte Palette von einer Standardpalette unterscheiden:
- Erstellen Sie Rampen in OKLCH. Die Helligkeit bleibt über verschiedene Farbtöne hinweg wahrnehmbar gleich, sodass ein 600er Blau und ein 600er Grün das gleiche visuelle Gewicht haben. HSL-Helligkeit lügt.
- Tönen Sie die Neutraltöne. Reines Grau und reines Schwarz oder Weiß wirken unbesessen. Fügen Sie eine kleine Menge Chroma (etwa 0.005 bis 0.015) in Richtung des Markenfarbtons hinzu.
- Text auf einer farbigen Oberfläche verwendet einen dunklen Farbton dieser Oberfläche, nicht neutrales Grau. Grau auf Farbe wirkt ausgewaschen.
- Wählen Sie einen Grad der Festlegung und halten Sie ihn: zurückhaltend (neutraler Grund, eine Akzentfarbe), festgelegt (Markenfarbton durchgängig präsent), volle Palette oder getränkt (Markenfarbton ist der Grund). Eine halbe Festlegung wirkt wie Unentschlossenheit.
- Lassen Sie Farbe niemals allein Bedeutung tragen. Kombinieren Sie sie mit einem Symbol, einer Beschriftung oder einem Muster.
- Achten Sie auf die aktuellen Reflexe. Eine warme Cremeseite mit einer Serifen-Auszeichnungsschrift und einem Terrakotta-Akzent oder ein fast schwarzer Grund mit einem säurehaltigen Akzent sind das, wozu generierte Designs greifen, wenn nichts entschieden wurde. Verwenden Sie sie nur, wenn der Richtungsabsatz dies verlangt.
Kontrast (WCAG 2.2)
| Paar | AA | AAA |
|---|---|---|
| Fließtext (unterhalb großer Schrift) | 4,5:1 | 7:1 |
| Große Schrift: 24px normal oder etwa 18,7px fett und größer | 3:1 | 4,5:1 |
| UI-Komponentengrenzen, Symbole, Fokusindikatoren, Diagrammmarkierungen mit Bedeutung | 3:1 | keine |
- Platzhaltertext, der dem Benutzer etwas mitteilt, ist Text: 4,5:1.
- Deaktivierte Steuerelemente sind ausgenommen, aber ein Benutzer muss dennoch sehen können, dass ein Steuerelement vorhanden ist.
- Messen Sie berechnete Farben, einschließlich Deckkraft und Überlagerungen. Eine Beschriftung mit 60 % Deckkraft auf einer getönten Karte ist eine neue Farbe.
Typografie
- Wählen Sie Schriften basierend auf der Register des Inhalts, nicht aus Gewohnheit. Drei Rollen: eine ausdrucksstarke Auszeichnungsschrift, sparsam verwendet; eine komfortable Fließtextschrift; eine Gebrauchsschrift für Beschriftungen, Bildunterschriften und Daten (Tabellenziffern für Zahlen in Tabellen).
- Kombinieren Sie mit einem klaren Kontrast (Serife mit Sans-Serife, geometrisch mit humanistisch) oder verwenden Sie eine Familie über verschiedene Strichstärken hinweg. Zwei Schriften, die ähnlich, aber nicht gleich sind, wirken wie ein Fehler.
- Modulare Skala. Wählen Sie ein Verhältnis: 1,2 für dichte Produkt-UI, 1,25 bis 1,333 für Inhalte und Marketing. Benennen Sie Rollen, nicht Größen:
display,h1bish4,body-lg,body,body-sm,label,caption. - Zeilenlänge 60 bis 75 Zeichen für Fließtext (
max-width: 70ch). - Auszeichnungsschriften erhalten einen engeren Buchstabenabstand (etwa
-0.02embis-0.04em) und eine Größenobergrenze (etwa 6rem überclamp()). Größer wirkt selten beabsichtigt. text-wrap: balancebei Überschriften,text-wrap: prettybei Fließtext.- Zeilenabstand: etwa 1,5 für Fließtext, 1,1 bis 1,25 für Auszeichnungsschriften.
Raum, Form, Tiefe
- Abstandsskala auf einer 4er- oder 8er-Basis: zum Beispiel 4, 8, 12, 16, 24, 32, 48, 64. Komponenten verwenden Tokens, niemals rohe Pixelwerte.
- Radius: zwei oder drei Werte mit einer Regel, wo welcher angewendet wird. Verschachtelte Radien: Der innere Radius entspricht dem äußeren Radius minus dem Abstand zwischen ihnen.
- Höhe: drei oder vier Ebenen, jede mit einer Funktion (ruhende Karte, Dropdown, Modal). Verwenden Sie in dunklen Designs eine hellere Oberfläche, um die Höhe anzuheben, keinen schwereren Schatten.
Bewegung
- Tokens: Dauern (z. B. 120ms, 200ms, 320ms) und zwei oder drei Beschleunigungskurven (eine für das Erscheinen, eine schärfere für das Verschwinden). Elemente verwenden sie wieder; niemand wählt einen pro Element spezifischen Wert.
- Bewegung erklärt eine Änderung: woher etwas kam, was reagiert hat. Bewegung, die nur dekoriert, wirkt generiert.
- Ein choreografierter Moment ist besser, als wenn alles gleichzeitig einblendet.
- Beachten Sie
prefers-reduced-motion: reduce: Entfernen Sie Bewegung und lange Übergänge, behalten Sie Deckkraftänderungen bei. - Skalieren Sie Fotos nicht beim Hovern. Animieren Sie den Container (Schatten, Rahmen, Hintergrund).
Dark Mode
- Ein dunkles Design ist eine Neuzuordnung von semantischen Tokens, niemals eine Umkehrung. Verwenden Sie dunkle Graustufen für den Grund, nicht reines Schwarz, und reduzieren Sie das Chroma von Akzentfarben, die leuchten.
- Überprüfen Sie jedes Kontrastpaar im dunklen Design erneut.
- Verhindern Sie das Aufblitzen des falschen Designs: Bestimmen Sie das Design in einem kleinen Inline-Skript im Dokumentenkopf, vor dem ersten Paint.
Lesen Sie references/dark-mode.md bei der Implementierung von Theme-Wechseln, Persistenz oder Bildern im Dark Mode.
Komponentenspezifikationen
Lesen Sie references/component-spec.md, bevor Sie eine Komponentenspezifikation schreiben. Es enthält die Vorlage und die Checkliste für Zustände.
Fallstricke
- 11 Farbtöne namens 100 bis 900. Das sind 9 Schritte. Benennen Sie Rampen so, dass Anzahl und Namen übereinstimmen (50, 100 ... 900, 950 ergibt 11).
- "Große Schrift" bedeutet 18 Punkt, nicht 18 Pixel. 18px normaler Fließtext benötigt 4,5:1, nicht 3:1. Der Schwellenwert für große Schrift ist 24px normal oder etwa 18,7px fett.
- Primitive Tokens in Komponenten. Funktioniert bis zum ersten Theme. Dann muss jede Komponente bearbeitet werden.
- Kontrast im Mockup überprüft, nicht im Build. Deckkraft, Überlagerungen und Antialiasing ändern die tatsächliche Farbe. Messen Sie die gerenderten Pixel oder die berechneten Stile.
- Eine globale Anpassung zur Behebung eines lokalen Problems. Die gesamte Palette abdunkeln, um ein einzelnes fehlschlagendes Paar zu retten, verschiebt alle anderen Paare. Korrigieren Sie das Token des Paares.
- Ein Token, das niemand verwendet, oder ein Rohwert, den niemand tokenisiert hat. Beides bedeutet, dass das System und der Build auseinandergedriftet sind. Durchsuchen Sie den Build nach rohen Hex- und Pixelwerten.
- Eine neue Schriftart, die für eine Überschrift geladen wurde. Jede Schriftart kostet Ladezeit. Verwenden Sie die Schriften, die das System bereits lädt.
Überprüfung
- Richtungsabsatz geschrieben, und jede Token-Familie kann darauf zurückgeführt werden.
- Jedes Text- und UI-Paar besteht AA in hell und dunkel, gemessen auf der gebauten Seite.
- Komponenten verwenden nur semantische Tokens: grep zeigt keine rohen Farb- oder Abstandswerte im Komponentencode.
- Jede Komponentenspezifikation listet alle ihre Zustände auf.
- Einstellung für reduzierte Bewegung getestet: Es bleibt keine Bewegung übrig.
- Theme-Wechsel zeigt kein Aufblitzen bei einem harten Neuladen mit der entgegengesetzten Systemeinstellung.