Couleurs OKLCH
OKLCH est un espace colorimétrique perceptuellement uniforme où la luminosité, la chroma et la teinte sont des contrôles de conception utiles. Utilisez-le lorsque le projet utilise déjà OKLCH, lors de la création d'un nouveau système de couleurs, ou lorsque l'utilisateur demande une conversion ou un travail de palette. Sinon, conservez les tokens et la notation établis du projet : un système de tokens hex ou RGB cohérent est préférable à l'introduction d'une seconde représentation de couleur pour une correction isolée. Pour explorer en interactif, visitez oklch.fyi.
Référence rapide
| Catégorie | Quand l'utiliser | Référence |
|---|---|---|
| Conversion | Hex/rgb/hsl vers oklch | color-conversion.md |
| Palettes | Générer des échelles, multi-teintes, mode sombre | palette-generation.md |
| Contraste | Vérifications APCA/WCAG, signalement des échecs, correction sur demande | accessibility-contrast.md |
| Gamut & Tailwind | Fallbacks P3, échelles @theme, clamp de gamut | gamut-and-tailwind.md |
| Utilisation | Tokens sémantiques, une signification par couleur, emphase de l'action principale, variantes d'apparence | color-usage.md |
Principes fondamentaux
1. Utiliser un espace colorimétrique perceptuel
- Respectez le système existant. Ne convertissez pas la notation simplement parce que ce skill est chargé. Réutilisez les tokens sémantiques et le format d'édition du projet, sauf si la tâche inclut une migration du système de couleurs.
- Uniformité perceptuelle. Des pas L égaux = une luminosité égale.
oklch(0.5 ...)est visuellement au milieu. Lalightness: 50%de HSL varie énormément selon la teinte. - Teinte stable. Le bleu HSL se déplace vers le violet lorsque la luminosité change. La teinte OKLCH reste constante sur toute la plage de luminosité.
- Chroma indépendante. La chroma est une mesure absolue de la saturation qui ne dépend pas de la luminosité. La saturation HSL en dépend.
- Gamut fini. Toutes les valeurs oklch ne correspondent pas à une couleur sRGB affichable. Les valeurs à haute chroma sur certaines teintes seront écrêtées ; une connaissance du gamut est nécessaire.
2. Écrire et formater OKLCH de manière cohérente
oklch(L C H)
oklch(L C H / alpha)
| Canal | Plage | Description |
|---|---|---|
| L (Luminosité) | 0–1 | 0 = noir, 1 = blanc. Perceptuellement uniforme. |
| C (Chroma) | 0–~0.4 | Saturation. 0 = gris. Le maximum dépend de L et H. |
| H (Teinte) | 0–360 | Angle de teinte en degrés. |
| alpha | 0–1 | Transparence optionnelle. Syntaxe slash. |
oklch(0.637 0.237 25.331)
oklch(0.8 0.05 200 / 0.5)
Utilisez trois décimales pour L et C et jusqu'à trois pour H. Supprimez les zéros de fin et formatez -0 comme 0. OKLCH est Baseline 2023 ; lorsque les exigences de prise en charge sont exceptionnellement larges, vérifiez la matrice de navigateurs du projet cible au lieu de vous fier à un pourcentage de couverture globale fixe.
3. Mesurer le contraste, le gamut et le comportement de la palette
| Règle | Valeur |
|---|---|
| Limite clair/sombre | L > 0.73 = fond clair → texte foncé ; en dessous, le texte clair obtient toujours un score plus élevé |
| Écart de luminosité (fond clair) | L avant-plan < 0.35 lorsque L fond > 0.9 |
| Écart de luminosité (fond sombre) | L avant-plan > 0.9 lorsque L fond < 0.25 |
| Seuil de dérive de teinte | Écart > 10° entre les étapes de la palette = dérive visible |
| Texte APCA corps | |Lc| >= 75 minimum, >= 90 préféré |
| Texte APCA non corps | |Lc| >= 60 minimum |
| Texte normal WCAG 2 | 4.5:1 AA, 7:1 AAA |
| Correction de contraste (uniquement sur demande) | Ajustez L d'abord ; préservez C et H si possible, puis remesurez la paire rendue |
Erreurs courantes
| Problème | Correction |
|---|---|
| Une couleur brute contourne le système de tokens sémantiques du projet | Réutilisez ou ajoutez le token de rôle correct dans la notation existante du projet |
| Valeur OKLCH isolée introduite dans une base de code hex/RGB | Conservez la notation établie sauf si la tâche inclut une migration du système de couleurs |
| Rampe de palette HSL avec dérive de teinte | Reconstruisez avec une teinte oklch constante |
| Contraste insuffisant (vérifiez l'avant-plan par rapport à son fond avec APCA) | Signalez la paire, son Lc mesuré et le seuil manqué ; ne modifiez les couleurs que sur demande (puis ajustez L, conservez C et H) |
| Haute chroma sans vérification de gamut | Clampez à la chroma maximale pour le L/H dans sRGB |
| Même C absolu sur différentes teintes | Utilisez le même % de C (pourcentage du maximum) pour une vivacité cohérente |
| Couleur P3 sans fallback sRGB | Ajoutez le modèle @media (color-gamut: p3) |
| Mode sombre créé en inversant mécaniquement la palette claire | Utilisez la palette claire comme point de départ, puis ajustez la chroma et la luminosité et revérifiez chaque paire avant-plan/fond |
Hex dans @theme de Tailwind v4 | Convertissez en valeurs oklch |
| Alpha avec syntaxe virgule | Utilisez slash : oklch(L C H / alpha) |
| Même teinte signifie deux choses différentes (couleur de lien réutilisée à des fins décoratives) | Une couleur, une signification ; donnez à la deuxième utilisation une couleur neutre |
| Token sémantique utilisé en dehors de son rôle (séparateur comme texte) | Ajoutez un token pour le rôle manquant ; n'empruntez jamais par valeur |
| Plusieurs fonds de contrôle colorés dans une même vue | Remplissez uniquement l'action primaire unique ; les secondaires restent neutres |
| Palette vérifiée uniquement en mode clair | Revérifiez chaque paire avant-plan/fond dans les deux apparences |
Format de sortie de révision
Utilisez ce format uniquement lorsque l'utilisateur demande une révision de couleur autonome. Lorsque better-interface orchestre la révision, fournissez les preuves et conclusions du domaine à ce skill et laissez son format de sortie, son échelle de gravité, ses règles de consolidation, son plafonnement et son verdict primer.
Présentez la révision autonome en deux parties.
Constatations
Regroupez toutes les constatations confirmées par principe. Utilisez un tableau markdown avec les colonnes Gravité, Emplacement, Avant, Après et Pourquoi. N'utilisez jamais de lignes "Avant :" / "Après :" séparées.
- Gravité :
HIGHrend le contenu illisible ou attribue une couleur sémantique trompeuse ;MEDIUMcrée un problème notable de thème, de gamut ou de cohérence ;LOWest un polissage isolé. - Emplacement : citez
chemin/vers/fichier:ligne. Si l'artefact n'a pas de fichier source, citez l'écran et le composant exacts. - Avant / Après : affichez la valeur ou le token actuel et le remplacement exact.
- Pourquoi : nommez le principe violé et incluez les preuves de contraste ou de gamut mesurées le cas échéant.
Consolidez un problème systémique répété en une seule ligne et listez tous les emplacements affectés. Omettez les principes sans constatations.
| Gravité | Emplacement | Avant | Après | Pourquoi |
|---|---|---|---|---|
| MEDIUM | src/theme.css:18 | color: #3b82f6 | color: oklch(0.623 0.188 259.815) | Les nouvelles couleurs du projet utilisent des tokens OKLCH |
| MEDIUM | src/palette.ts:31 | Même C absolu sur toutes les teintes | Même %C de la chroma maximale de chaque teinte | Des valeurs de chroma égales n'apparaissent pas aussi vives sur toutes les teintes |
| HIGH | src/theme.css:52 | Couleur P3 sans fallback | Ajoutez un fallback sRGB avant @media (color-gamut: p3) | La couleur échoue sur les écrans non P3 |
Vérification et verdict
Après les constatations :
- Vérification : listez les vérifications exactes effectuées et leurs résultats observés, y compris les mesures de contraste, les vérifications de gamut, et les apparences claire et sombre le cas échéant. Si une vérification n'a pas été effectuée, indiquez ce qui nécessite encore une vérification.
- Verdict :
Bloquantsi une constatationHIGHsubsiste,Modifications nécessairessi seules des constatationsMEDIUMouLOWsubsistent, etApprouvéuniquement lorsqu'aucune constatation exploitable ne subsiste.
Lorsqu'il n'y a aucune constatation, omettez le tableau, indiquez "Aucune constatation de couleur exploitable", rapportez la vérification et terminez par Approuvé.