Design tokens
Un petit ensemble de valeurs nommées, utilisées partout, est ce qui donne à un site une apparence conçue plutôt qu'assemblée. Définissez les jetons avant les composants ; modifier une marque plus tard revient alors à modifier un seul bloc.
Que demander
Une couleur de marque principale (ou un mot d'ambiance), une base claire ou sombre, et le ton (corporate, ludique, éditorial, technique). Tout le reste peut en découler.
Couleur
Travaillez par rôles, et non par noms de couleurs, afin qu'un changement de marque n'exige pas de renommage.
| Jeton | Rôle | Règle empirique |
|---|---|---|
--bg | Fond de page | Blanc cassé ou presque noir, jamais du #fff ou #000 pur |
--surface | Cartes, champs de saisie | 2 à 4% d'écart de luminosité par rapport à --bg |
--text | Texte principal | Au moins 7:1 par rapport à --bg |
--muted | Texte secondaire | Au moins 4.5:1 par rapport à --bg |
--border | Filets | 10 à 15% de la couleur du texte mélangé au fond |
--accent | Boutons, mises en évidence | La couleur de la marque |
--accent-ink | Liens et texte d'accentuation sur --bg | La couleur de la marque, assombrie (ou éclaircie sur fond sombre) jusqu'à passer le 4.5:1 |
--on-accent | Texte sur l'accent | La couleur, blanche ou foncée, qui passe le 4.5:1 |
Conseils :
- Teintez légèrement les neutres vers la teinte d'accentuation (2 à 6% de saturation). Des gris purs à côté d'un accent chaud semblent sans lien.
- Utilisez l'accent sur environ 10% de la surface. Si tout est accentué, rien ne l'est.
- Un second accent est rarement nécessaire. Ajoutez-en un seulement pour une signification distincte, comme le succès ou une promotion.
- Pour le mode sombre, n'inversez pas. Augmentez la luminosité de la surface à mesure que l'élévation augmente et réduisez un peu la saturation de l'accent pour qu'il ne brille pas.
Si l'interface en ligne de commande webcraft est disponible, générez un ensemble de départ plutôt que de dériver les valeurs manuellement. Il applique toutes les règles ci-dessus, résout la luminosité jusqu'à ce que chaque paire réussisse, et construit le thème sombre séparément :
webcraft tokens "#e4572e" --tone editorial -o tokens.css # aussi : --base dark, --radius pill
webcraft tokens "#e4572e" --format theme-json # WordPress theme.json avec les mêmes valeurs
Dans un client MCP, la même chose est réalisée avec l'outil generate_tokens. Traitez la sortie comme une première ébauche : ajustez à l'œil, puis revérifiez.
Vérifiez chaque paire de texte et de fond avant de finaliser :
webcraft contrast "#1b1b1f" "#f6f4ef"
webcraft contrast --tokens tokens.css
python scripts/contrast.py --tokens tokens.css # solution de secours sans installation, valeurs hex uniquement
La première forme imprime le rapport et les niveaux WCAG pour une paire. La seconde lit un fichier CSS et vérifie les paires de rôles standard dans chaque bloc de thème (:root, [data-theme], prefers-color-scheme), en résolvant var() et en lisant les valeurs hexadécimales, rgb(), hsl(), oklch() et color-mix(). Les paires défaillantes sont le défaut d'accessibilité le plus courant sur les nouveaux sites, et elles sont invisibles pour les personnes ayant une bonne vision sur un bon écran, c'est pourquoi il s'agit d'un script et non d'un jugement subjectif.
Typographie
- Deux familles au maximum : une pour les titres, une pour le corps de texte. Une seule famille en deux graisses est souvent préférable.
- Associez par contraste de structure (sérif pour l'affichage avec un sans-sérif pour le corps, ou un condensé pour l'affichage avec un corps régulier), et non deux sans-sérif similaires.
- Taille du corps de 16 à 18 px, hauteur de ligne de 1,5 à 1,7, longueur de ligne de 60 à 75 caractères.
- Police d'affichage : hauteur de ligne de 0,95 à 1,1, crénage négatif qui augmente avec la taille.
- Échelle fluide avec
clamp()pour qu'il n'y ait pas de sauts entre les points de rupture :
:root {
--step--1: clamp(0.83rem, 0.8rem + 0.15vw, 0.9rem);
--step-0: clamp(1rem, 0.95rem + 0.25vw, 1.125rem);
--step-1: clamp(1.25rem, 1.1rem + 0.6vw, 1.6rem);
--step-2: clamp(1.6rem, 1.3rem + 1.3vw, 2.4rem);
--step-3: clamp(2rem, 1.5rem + 2.6vw, 3.6rem);
--step-4: clamp(2.5rem, 1.6rem + 4.6vw, 5.5rem);
--step-5: clamp(3rem, 1.5rem + 7vw, 7.5rem);
}
- Chargez les polices avec
font-display: swap, préchargez le ou les deux fichiers utilisés au-dessus de la ligne de flottaison, et créez des sous-ensembles si vous les hébergez vous-même.
Espacement, coins arrondis, ombre
:root {
--space-1: 0.25rem; --space-2: 0.5rem; --space-3: 0.75rem; --space-4: 1rem;
--space-6: 1.5rem; --space-8: 2rem; --space-12: 3rem; --space-16: 4rem;
--section: clamp(4rem, 3rem + 6vw, 9rem); /* espacement vertical entre les sections */
--gutter: clamp(1rem, 0.5rem + 3vw, 3rem); /* remplissage latéral de la page */
--container: 76rem;
--radius-sm: 8px; --radius: 16px; --radius-lg: 28px; --radius-pill: 999px;
--shadow: 0 1px 2px rgb(0 0 0 / .04), 0 8px 24px rgb(0 0 0 / .06);
}
- Choisissez une personnalité de coin (carré, doux ou pilule) et tenez-vous-y. Des coins arrondis mixtes sont le moyen le plus rapide de paraître incohérent.
- L'espacement entre les sections doit être nettement plus grand que l'espacement à l'intérieur de celles-ci ; cet écart indique à l'œil où une section se termine.
Résultat
Fournissez un seul fichier tokens.css avec un bloc :root, un bloc optionnel [data-theme="dark"], et un court tableau indiquant quel jeton est utilisé où. Indiquez ensuite les résultats de contraste pour le texte principal, le texte secondaire et le texte des boutons.
Rebranding d'un site existant
Commencez par associer les valeurs codées en dur existantes aux rôles (recherchez les codes hexadécimaux dans le CSS et comptez les occurrences), remplacez-les par des jetons, vérifiez que rien n'a changé visuellement, puis échangez les valeurs des jetons. Faire les deux à la fois rend les régressions impossibles à tracer.