Conception visuelle
Le système sous-jacent à chaque écran : jetons pour la couleur, la typographie, l'espace, la forme, la profondeur et l'animation, ainsi que les spécifications des composants qui en découlent. La compétence designer applique ce système à des pages réelles. Construisez le système une fois ; laissez les pages le dépenser.
Les règles les plus importantes
- Rédigez la direction de conception en mots avant tout jeton. Trois ou quatre phrases : à qui elle s'adresse, ce qu'elle doit ressentir, ce qu'elle ne doit jamais ressentir, et la seule chose qu'elle emprunte au sujet. Chaque décision de jeton est vérifiée par rapport à ce paragraphe.
- Les composants référencent des jetons sémantiques, jamais des primitives.
--color-text-primary, pas--grey-900. Le mode sombre, le thème et les changements de marque deviennent alors une remise en correspondance, pas une réécriture. - Vérifiez le contraste pour chaque paire réelle, dans les deux thèmes, par rapport au tableau ci-dessous. Une palette qui passe sur du blanc peut échouer sur sa propre surface teintée.
- Une valeur par défaut n'est pas une décision. Les gris du framework, Inter partout, un rayon de 4 px sur chaque boîte : chacun semble correct et ensemble, ils ressemblent à tous les autres produits. Décidez chaque valeur ou acceptez-la en connaissance de cause.
- Chaque spécification de composant énumère tous ses états : défaut, survol, focus, actif, désactivé, chargement, erreur et sélectionné le cas échéant. Les états manquants sont inventés lors de la construction, de manière incohérente.
- Moins de valeurs, utilisées de manière cohérente. Une échelle de 6 niveaux utilisée partout bat une échelle de 14 niveaux utilisée au hasard.
Quand ne pas l'utiliser
- Organiser une page spécifique, choisir ce qui se trouve au-dessus de la ligne de flottaison, critiquer un écran ou mener une refonte :
designer. - Générer des illustrations, des icônes, des images de héros ou des marques :
artiste. - Graphiques et palettes de visualisation de données : la compétence
frontendreferences/charts.md. Les couleurs catégorielles des graphiques ont des contraintes qu'une palette de marque n'a pas. - Implémenter les jetons dans un framework :
frontend.
Ordre de construction
Chaque couche dépend de la précédente :
- Paragraphe de direction.
- Couleur : primitives, puis jetons sémantiques.
- Typographie : polices, puis échelle et rôles.
- Échelle d'espacement et grille.
- Rayon, bordure et élévation.
- Jetons d'animation.
- Jetons de composants et spécifications de composants.
Couleur
Structure :
Primitives (valeurs brutes, une rampe par teinte, par exemple 50, 100 ... 900, 950) :
--blue-600: oklch(0.55 0.17 255)
Jetons sémantiques (référencent les primitives, nommés par fonction) :
--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 (chacun avec une variante sûre pour le texte)
Règles qui distinguent une palette réfléchie d'une palette par défaut :
- Construisez les rampes en OKLCH. La luminosité reste perceptuellement uniforme entre les teintes, donc un bleu 600 et un vert 600 ont le même poids visuel. La luminosité HSL ment.
- Teintez les neutres. Le gris pur et le noir ou blanc pur semblent sans propriétaire. Ajoutez une petite quantité de chroma (environ 0,005 à 0,015) vers la teinte de la marque.
- Le texte sur une surface colorée utilise une nuance foncée de la teinte de cette surface, pas du gris neutre. Le gris sur la couleur semble délavé.
- Choisissez un niveau d'engagement et tenez-le : retenu (fond neutre, un accent), engagé (teinte de marque présente partout), palette complète, ou saturé (la teinte de marque est le fond). Un demi-engagement ressemble à de l'indécision.
- Ne laissez jamais la couleur porter seule le sens. Associez-la à une icône, une étiquette ou un motif.
- Méfiez-vous des réflexes courants. Une page crème chaleureuse avec une police d'affichage à empattements et un accent terre cuite, ou un noir presque pur avec un accent acide, sont ce que les designers atteignent par réflexe quand rien n'a été décidé. Utilisez-les uniquement lorsque le paragraphe de direction le demande.
Contraste (WCAG 2.2)
| Paire | AA | AAA |
|---|---|---|
| Texte du corps (en dessous de la grande taille) | 4,5:1 | 7:1 |
| Texte large : 24 px standard, ou environ 18,7 px en gras, et plus | 3:1 | 4,5:1 |
| Limites des composants d'interface, icônes, indicateurs de focus, marques de graphiques qui portent du sens | 3:1 | aucune |
- Le texte indicatif qui communique quelque chose à l'utilisateur est du texte : 4,5:1.
- Les contrôles désactivés sont exemptés, mais l'utilisateur doit toujours voir qu'un contrôle est présent.
- Mesurez les couleurs calculées, y compris l'opacité et les superpositions. Une étiquette à 60 % d'opacité sur une carte teintée est une nouvelle couleur.
Typographie
- Choisissez les polices pour le registre du contenu, pas par habitude. Trois rôles : une police d'affichage avec du caractère, utilisée avec parcimonie ; une police de corps confortable ; une police utilitaire pour les étiquettes, les légendes et les données (chiffres tabulaires pour les nombres dans les tableaux).
- Associez sur un contraste clair (empattement avec sans-empattement, géométrique avec humaniste) ou utilisez une seule famille sur plusieurs graisses. Deux polices similaires mais pas identiques ressemblent à une erreur.
- Échelle modulaire. Choisissez un ratio : 1,2 pour une interface produit dense, 1,25 à 1,333 pour le contenu et le marketing. Nommez les rôles, pas les tailles :
display,h1àh4,body-lg,body,body-sm,label,caption. - Mesure 60 à 75 caractères pour le texte du corps (
max-width: 70ch). - Le texte d'affichage bénéficie d'un crénage plus serré (environ
-0.02emà-0.04em) et d'un plafond de taille (environ 6 rem viaclamp()). Plus grand semble rarement intentionnel. text-wrap: balancesur les titres,text-wrap: prettysur la prose du corps.- Hauteur de ligne : environ 1,5 pour le corps, 1,1 à 1,25 pour l'affichage.
Espace, forme, profondeur
- Échelle d'espacement sur une base de 4 ou 8 : par exemple 4, 8, 12, 16, 24, 32, 48, 64. Les composants utilisent des jetons, jamais de valeurs brutes en pixels.
- Rayon : deux ou trois valeurs avec une règle pour savoir où chacune s'applique. Rayons imbriqués : le rayon intérieur est égal au rayon extérieur moins le rembourrage entre eux.
- Élévation : trois ou quatre niveaux, chacun lié à une fonction (carte au repos, menu déroulant, modale). Dans les thèmes sombres, augmentez l'élévation avec une surface plus claire, pas une ombre plus lourde.
Animation
- Jetons : durées (par exemple 120ms, 200ms, 320ms) et deux ou trois courbes d'assouplissement (une pour l'entrée, une plus marquée pour la sortie). Les éléments les réutilisent ; personne ne choisit une valeur par élément.
- L'animation explique un changement : d'où vient quelque chose, ce qui a réagi. Une animation qui ne fait que décorer semble générée.
- Un moment chorégraphié bat tout ce qui apparaît en fondu en même temps.
- Respectez
prefers-reduced-motion: reduce: supprimez le mouvement et les transitions longues, conservez les changements d'opacité. - Ne zoomez pas les photos au survol. Animez le conteneur (ombre, bordure, fond).
Mode sombre
- Un thème sombre est une remise en correspondance des jetons sémantiques, jamais une inversion. Utilisez des gris foncés pour le fond, pas du noir pur, et réduisez le chroma des accents qui brillent.
- Re-vérifiez chaque paire de contraste dans le thème sombre.
- Évitez le flash du mauvais thème : décidez le thème dans un petit script en ligne dans l'en-tête du document, avant la première peinture.
Consultez references/dark-mode.md lors de l'implémentation du changement de thème, de la persistance ou des images en mode sombre.
Spécifications des composants
Consultez references/component-spec.md avant d'écrire une spécification de composant. Il contient le modèle et la liste de contrôle des états.
Pièges
- 11 nuances nommées 100 à 900. Cela fait 9 étapes. Nommez les rampes pour que le nombre et les noms correspondent (50, 100 ... 900, 950 donne 11).
- "Texte large" signifie 18 points, pas 18 pixels. Un texte de corps de 18 px standard nécessite 4,5:1, pas 3:1. Le seuil de texte large est de 24 px standard ou environ 18,7 px en gras.
- Jetons primitifs dans les composants. Fonctionne jusqu'au premier thème. Ensuite, chaque composant nécessite une modification.
- Contraste vérifié sur la maquette, pas sur la version construite. L'opacité, les superpositions et l'anti-crénelage modifient la couleur réelle. Mesurez les pixels rendus ou les styles calculés.
- Un ajustement global pour résoudre un problème local. Assombrir toute la palette pour sauver une paire défaillante modifie toutes les autres paires. Corrigez le jeton de la paire.
- Un jeton que personne n'utilise, ou une valeur brute que personne n'a tokenisée. Les deux signifient que le système et la version construite ont dérivé. Recherchez les valeurs hexadécimales brutes et les valeurs de pixels dans la version construite.
- Une nouvelle police chargée pour un seul titre. Chaque police coûte du temps de chargement. Utilisez les polices que le système charge déjà.
Vérification
- Paragraphe de direction rédigé, et chaque famille de jetons peut y être rattachée.
- Chaque paire de texte et d'interface passe AA en mode clair et sombre, mesurée sur la page construite.
- Les composants utilisent uniquement des jetons sémantiques : la recherche montre aucune valeur de couleur ou d'espacement brute dans le code des composants.
- Chaque spécification de composant énumère tous ses états.
- Paramètre de mouvement réduit testé : aucun mouvement ne reste.
- Le changement de thème n'affiche aucun flash lors d'un rechargement forcé avec le paramètre système opposé.