Système de design
Présentation
Un système de design est l'endroit où une décision est prise une fois puis réutilisée partout. Chaque couleur est un token, chaque élément interactif montre tous ses états, et chaque changement atteint tous les écrans qui utilisent l'élément. Construisez-le en couches, fondations d'abord, et arrêtez-vous pour validation à chaque couche. Un audit rapporte et ne corrige jamais tout seul.
Quand l'utiliser
- "Démarrer un guide de style / système de design / tokens pour …"
- Ajouter un composant, une variante ou un token, ou en modifier un existant.
- "Rendre ces écrans cohérents", "standardiser", "auditer le guide", ou des valeurs hexadécimales isolées et des pièces uniques dans les écrans.
Quand NE PAS l'utiliser
- Une question sur une valeur ("quelle est notre couleur primaire?") : répondez-y.
- Une petite modification que la personne a décrite exactement (une valeur, un libellé, une taille), même sur un élément partagé : changez-la une fois là où elle est définie et dites quels écrans cela affecte. Pas de matrice d'états, pas d'arrêt.
Avant de commencer
- Lisez
DESIGN.mdà la racine du projet s'il existe : c'est le briefing de design du projet. - Trouvez ce qui existe : les tokens, le guide, les composants, les écrans et le code. Un guide existant prévaut sur l'apparence. Suivez ses règles même si elles diffèrent des valeurs par défaut ci-dessous, et mentionnez la différence une fois.
- Choisissez l'adaptateur de votre outil dans
references/adapters/(paper.md,figma.md,html.md). Si aucun adaptateur ne correspond à votre outil, effectuez les mêmes actions dans votre outil et dites lesquelles vous avez adaptées manuellement. Sans outil de design du tout, construisez en HTML (html.md). Si vous n'avez qu'une image, dites que les valeurs lues sont des estimations. - Décidez du mode : créer, ajouter ou modifier, ou auditer.
Étapes · créer
-
Brouillon des fondations :
- rôles de couleurs (rôles de tokens);
- échelle typographique;
- espacement;
- rayon;
- ombres (deux au maximum);
- largeurs de mise en page;
- durées d'animation;
- une courte section "comment nous écrivons".
Nommez les tokens par rôle (
text-muted,border-hover,danger-bg), jamais seulement par valeur (gray-500). -
Règles d'interaction, une fois : pour les éléments avec bordure, sans bordure et l'action primaire, écrivez à quoi ressemblent le survol, l'enfoncement, le focus (clavier uniquement), désactivé, chargement et sélectionné. Les composants suivent ces règles plutôt que d'en inventer chacun.
-
Arrêtez-vous et montrez à la personne les fondations et les règles d'interaction. Ne construisez pas encore les composants.
-
Composants un par un, dans l'ordre dont les premiers écrans ont besoin. Chacun reçoit une section du guide avec l'anatomie du composant : une légende avec la règle et le pourquoi, des exemples, et une matrice d'états des variantes × états. Ajoutez chacun à l'index des composants.
Étapes · ajouter ou modifier un élément
- Vérifiez si un composant existant plus une variante le couvre. Préférez la réutilisation à une pièce unique.
- Dessinez-le avec l'anatomie, y compris la matrice d'états complète. Une nouvelle couleur, taille ou icône devient un token ou une entrée dans le jeu d'icônes maintenant, pas plus tard.
- Listez chaque écran et emplacement de code qui utilise l'élément.
- Arrêtez-vous et montrez à la personne le changement et cette liste.
- Sur approbation, propagez :
- mettez à jour chaque écran de la liste;
- mettez à jour le code, le cas échéant;
- mettez à jour l'index des composants;
- rapportez ce qui a changé et où.
Étapes · auditer
- Exécutez la liste de vérification d'audit sur le guide, les écrans et le code s'il y en a.
- Rédigez le rapport : constats classés par sévérité, chacun avec où il se trouve, pourquoi il est important et la correction proposée.
- Arrêtez-vous et montrez à la personne le rapport. Ne modifiez aucun fichier jusqu'à ce qu'elle indique quelles corrections appliquer. Sauvegarder les originaux ne rend pas leur modification acceptable.
Règles
Fermes (tout projet) :
| Règle | Pourquoi |
|---|---|
| Chaque couleur est un token ; pas de valeurs hexadécimales isolées dans les écrans ou le code | Les valeurs isolées dérivent en quasi-doublons que personne ne peut changer d'un coup |
| Un seul jeu d'icônes | Les jeux mélangés ressemblent à des produits mélangés |
| Design et code changent ensemble, design en premier | Sinon le guide cesse d'être la vérité en une semaine |
| Chaque élément interactif a une matrice d'états | Les états dessinés au coup par coup sur les écrans ne s'accordent jamais |
| Un changement sur un élément partagé est listé avec les écrans qu'il affecte avant d'être propagé | Sinon un "petit" changement redessine silencieusement vingt écrans |
Valeurs par défaut (un guide existant les surcharge) :
| Valeur par défaut | Pourquoi |
|---|---|
| Au survol, les éléments avec bordure ne foncent que la bordure | Un arrière-plan changeant sur les cartes et champs semble lourd |
| Le survol est plus subtil que le sélectionné | Quand le survol ressemble au sélectionné, les gens pensent que deux choses sont choisies |
| La sélection ne change jamais le poids de la police | Un changement de poids déplace la largeur du texte |
| Les espaces réservés sont plus clairs que le texte atténué | Sinon un espace réservé se lit comme du texte saisi |
| Les éléments dans des listes empilées et des menus ont un petit écart, jamais collés | Les surbrillances collées fusionnent en un seul bloc |
| L'anneau de focus n'apparaît qu'avec le clavier | Un anneau après un clic souris ressemble à un bug |
| Le chargement conserve la taille exacte de l'élément | Décalage de mise en page |
| Les ombres uniquement sur les éléments flottants (menus, popovers, dialogues, toasts), à deux intensités | Des ombres partout aplatissent la hiérarchie qu'elles étaient censées créer |
| Au maximum une action primaire par écran | Deux primaires signifie que l'écran n'a pas décidé |
Fait quand
- Créer : fondations et règles d'interaction approuvées ; chaque composant a son anatomie, sa matrice d'états et une ligne dans l'index.
- Modifier : chaque écran et emplacement de code listé mis à jour, et l'index mis à jour.
- Auditer : un rapport classé remis et aucun fichier modifié.
Erreurs courantes
| Pensée | Réalité |
|---|---|
| "Je vais construire tout le guide d'un coup : tokens et dix composants" | Dix composants sur des fondations non approuvées signifient dix reprises. Fondations, arrêt, puis composants. |
| "L'audit a trouvé des problèmes, je vais juste les corriger" | La personne peut être en désaccord avec la moitié des corrections. Rapportez, arrêtez, corrigez seulement ce qu'elle choisit. |
| "J'ai gardé les originaux dans un dossier de sauvegarde, donc corriger est sûr" | Une sauvegarde ne rend pas la personne d'accord avec les corrections. Rapportez d'abord. |
| "Les boutons ont survol et désactivé, c'est assez" | Une matrice d'états a chaque état × chaque variante : normal, survol, enfoncé, focus, désactivé, chargement, sélectionné. |
"--teal-600 est un token" | C'est une valeur. Les composants ont besoin de rôles (--color-primary) pour que la valeur puisse changer en un endroit. |
| "Cet écran a besoin d'une carte légèrement différente" | Faites-en une variante de la carte, ou utilisez la carte. Une pièce unique est le début de la divergence. |