OKLCH-Farben
OKLCH ist ein wahrnehmungslinearer Farbraum, bei dem Helligkeit (Lightness), Buntheit (Chroma) und Farbton (Hue) nützliche Designsteuerungen sind. Verwende ihn, wenn das Projekt bereits OKLCH verwendet, wenn ein neues Farbsystem erstellt wird oder wenn der Benutzer nach Konvertierung oder Palettenarbeit fragt. Erhalte andernfalls die etablierten Tokens und Notationen des Projekts: Ein konsistentes Hex- oder RGB-Tokensystem ist besser, als eine zweite Farbdarstellung für eine isolierte Korrektur einzuführen. Für eine interaktive Erkundung besuche oklch.fyi.
Kurzreferenz
| Kategorie | Wann verwenden | Referenz |
|---|---|---|
| Konvertierung | Hex/RGB/HSL zu OKLCH | color-conversion.md |
| Paletten | Skalen, Mehrfarbtöne, Dark Mode generieren | palette-generation.md |
| Kontrast | APCA/WCAG-Prüfungen, Fehler melden, auf Anfrage beheben | accessibility-contrast.md |
| Gamut & Tailwind | P3-Fallback, @theme-Skalen, Gamut-Clipping | gamut-and-tailwind.md |
| Verwendung | Semantische Tokens, eine Bedeutung pro Farbe, Primäraktion-Hervorhebung, Erscheinungsvarianten | color-usage.md |
Kernprinzipien
1. Wahrnehmungslinearen Farbraum verwenden
- Das bestehende System respektieren. Notation nicht nur deshalb umwandeln, weil dieser Skill geladen wurde. Die semantischen Tokens und das Autorenformat des Projekts wiederverwenden, es sei denn, die Aufgabe umfasst eine Farbsystemmigration.
- Wahrnehmungslineare Gleichmäßigkeit. Gleiche L-Schritte = gleiche Helligkeit.
oklch(0.5 ...)ist visuell mittig. HSLslightness: 50%variiert stark je nach Farbton. - Stabiler Farbton. HSL-Blau verschiebt sich bei Helligkeitsänderungen ins Violette. Der OKLCH-Farbton bleibt über den gesamten Helligkeitsbereich konstant.
- Unabhängige Buntheit. Chroma ist ein absolutes Maß für Buntheit, das nicht von der Helligkeit abhängt. Die HSL-Sättigung tut dies.
- Endlicher Gamut. Nicht jeder OKLCH-Wert lässt sich in einem darstellbaren sRGB-Farben abbilden. Hochchromatische Werte bei bestimmten Farbtönen werden abgeschnitten; Gamut-Bewusstsein ist erforderlich.
2. OKLCH einheitlich schreiben und formatieren
oklch(L C H)
oklch(L C H / alpha)
| Kanal | Bereich | Beschreibung |
|---|---|---|
| L (Helligkeit) | 0–1 | 0 = schwarz, 1 = weiß. Wahrnehmungslinear. |
| C (Buntheit) | 0–~0.4 | Farbigkeit. 0 = grau. Maximalwert abhängig von L und H. |
| H (Farbton) | 0–360 | Farbtonwinkel in Grad. |
| alpha | 0–1 | Optionale Transparenz. Schrägstrich-Syntax. |
oklch(0.637 0.237 25.331)
oklch(0.8 0.05 200 / 0.5)
Verwende drei Dezimalstellen für L und C und bis zu drei für H. Lasse nachfolgende Nullen weg und formatiere -0 als 0. OKLCH ist Baseline 2023; wenn die Support-Anforderungen ungewöhnlich breit sind, überprüfe die Zielprojekt-Browser-Matrix anstatt dich auf einen festen globalen Abdeckungsprozentsatz zu verlassen.
3. Kontrast, Gamut und Palettenverhalten messen
| Regel | Wert |
|---|---|
| Hell/Dunkel-Grenze | L > 0.73 = heller Hintergrund → dunkler Text; darunter erzielt heller Text immer noch höhere Punktzahlen |
| Helligkeitslücke (heller Hintergrund) | Vordergrund-L < 0.35 wenn Hintergrund-L > 0.9 |
| Helligkeitslücke (dunkler Hintergrund) | Vordergrund-L > 0.9 wenn Hintergrund-L < 0.25 |
| Farbton-Drift-Schwelle | > 10° Streuung über Palettenschritte = sichtbare Drift |
| APCA-Fließtext | |
| APCA-Nicht-Fließtext | |
| WCAG 2 normaler Text | 4.5:1 AA, 7:1 AAA |
| Kontrastkorrektur (nur auf Anfrage) | Zuerst L anpassen; C und H nach Möglichkeit beibehalten, dann das gerenderte Paar erneut messen |
Häufige Fehler
| Problem | Lösung |
|---|---|
| Rohe Farbe umgeht das semantische Token-System des Projekts | Den korrekten Rollen-Token in der vorhandenen Notation des Projekts wiederverwenden oder hinzufügen |
| Isolierter OKLCH-Wert in einer Hex/RGB-Codebasis eingeführt | Die etablierte Notation beibehalten, es sei denn, die Aufgabe umfasst eine Farbsystemmigration |
| HSL-Palettenrampe mit Farbton-Drift | Mit konstantem OKLCH-Farbton neu aufbauen |
| Fehlgeschlagener Kontrast (Vordergrund gegen seinen Hintergrund mit APCA prüfen) | Das Paar, seinen gemessenen Lc und den verfehlten Schwellenwert melden; Farben nur ändern, wenn darum gebeten wird (dann L anpassen, C und H beibehalten) |
| Hohe Buntheit ohne Gamut-Prüfung | Auf maximale Buntheit für L/H im sRGB begrenzen |
| Gleiches absolutes C über verschiedene Farbtöne hinweg | Gleichen C% (Prozentsatz des Maximums) für konsistente Lebendigkeit verwenden |
| P3-Farbe ohne sRGB-Fallback | @media (color-gamut: p3)-Muster hinzufügen |
| Dunkelmodus durch mechanisches Umkehren der hellen Palette erstellt | Die helle Palette als Ausgangspunkt verwenden, dann Buntheit und Helligkeit abstimmen und jedes Vordergrund-/Hintergrundpaar erneut prüfen |
Hex in Tailwind v4 @theme | In OKLCH-Werte konvertieren |
| Alpha mit Komma-Syntax | Schrägstrich verwenden: oklch(L C H / alpha) |
| Gleicher Farbton bedeutet zwei verschiedene Dinge (Linkfarbe dekorativ wiederverwendet) | Eine Farbe, eine Bedeutung; der zweiten Verwendung ein Neutral geben |
| Semantischer Token außerhalb seiner Rolle verwendet (Trennzeichen als Text) | Einen Token für die fehlende Rolle hinzufügen; niemals nach Wert ausleihen |
| Mehrere farbige Steuerelement-Hintergründe in einer Ansicht | Nur die einzelne primäre Aktion füllen; Sekundärelemente bleiben neutral |
| Palette nur im hellen Modus verifiziert | Jedes Vordergrund-/Hintergrundpaar in beiden Erscheinungsformen erneut prüfen |
Ausgabeformat für Überprüfungen
Verwende dieses Format nur, wenn der Benutzer nach einer eigenständigen Farbüberprüfung fragt. Wenn better-interface die Überprüfung orchestriert, liefere Domänennachweise und Ergebnisse an diesen Skill und lasse sein Ausgabeformat, seine Schweregradskala, seine Zusammenfassungsregeln, die Höchstzahl und das Urteil den Vorrang haben.
Präsentiere die eigenständige Überprüfung in zwei Teilen.
Ergebnisse
Gruppiere alle bestätigten Ergebnisse nach Prinzip. Verwende eine Markdown-Tabelle mit Schweregrad, Ort, Vorher, Nachher und Warum-Spalten. Verwende niemals separate „Vorher:“ / „Nachher:“-Zeilen.
- Schweregrad:
HIGHmacht Inhalt unlesbar oder weist eine irreführende semantische Farbe zu;MEDIUMerzeugt einen spürbaren Theme-, Gamut- oder Konsistenzfehler;LOWist isolierte Politur. - Ort: zitiere
pfad/zu/datei:zeile. Wenn das Artefakt keine Quelldateien hat, zitiere stattdessen den genauen Bildschirm und die Komponente. - Vorher / Nachher: Zeige den aktuellen Wert oder Token und den genauen Ersatz.
- Warum: Nenne das verletzte Prinzip und füge gemessene Kontrast- oder Gamut-Nachweise bei, wenn relevant.
Fasse ein wiederholtes systemisches Problem in einer Zeile zusammen und liste jeden betroffenen Ort auf. Lasse Prinzipien ohne Ergebnisse weg.
| Schweregrad | Ort | Vorher | Nachher | Warum |
|---|---|---|---|---|
| MEDIUM | src/theme.css:18 | color: #3b82f6 | color: oklch(0.623 0.188 259.815) | Neue Projektfarben verwenden OKLCH-Tokens |
| MEDIUM | src/palette.ts:31 | Gleiches absolutes C über Farbtöne hinweg | Gleicher C% des maximalen Chromas jedes Farbtons | Gleiche Buntheitswerte erscheinen nicht über Farbtöne hinweg gleich lebendig |
| HIGH | src/theme.css:52 | P3-Farbe ohne Fallback | sRGB-Fallback vor @media (color-gamut: p3) hinzugefügt | Die Farbe funktioniert auf nicht-P3-Displays nicht |
Verifizierung und Urteil
Nach den Ergebnissen:
- Verifizierung: Liste die genauen durchgeführten Prüfungen und ihre beobachteten Ergebnisse auf, einschließlich Kontrastmessungen, Gamut-Prüfungen sowie sowohl helle als auch dunkle Erscheinungsformen, wenn zutreffend. Wenn eine Prüfung nicht durchgeführt wurde, gib an, was noch verifiziert werden muss.
- Urteil:
Block, wenn einHIGH-Ergebnis verbleibt,Änderung erforderlich, wenn nurMEDIUM- oderLOW-Ergebnisse verbleiben, undGenehmigennur, wenn keine umsetzbaren Ergebnisse mehr vorhanden sind.
Wenn es keine Ergebnisse gibt, lasse die Tabelle weg, gib an „Keine umsetzbaren Farbergebnisse“, melde die Verifizierung und beende mit Genehmigen.