Jetons de design : vue d’ensemble
Les jetons de design constituent les briques de base de tous les éléments d’interface utilisateur. Les mêmes jetons sont utilisés dans les maquettes, les outils et le code.
- Les jetons pointent vers des valeurs de style comme les couleurs, les polices de caractères et les dimensions
- Utilisez des jetons de design au lieu de valeurs codées en dur
- Chaque jeton est nommé selon son usage ou son emplacement (par exemple, md.comp.fab.primary.container.color définit la couleur du conteneur d’un FAB)
- Même si la valeur finale d’un jeton est modifiée, son nom et son utilisation restent identiques
- Material Design comporte trois classes de jetons : jetons de référence, jetons système et jetons de composant

Ressources
| Type | Lien | Statut |
|---|---|---|
| Design | Design Kit (Figma) | Disponible |
| Plugin Material Theme Builder pour Figma | Disponible | |
| Implémentation | Thème et jetons de base de Material (DSP) | Disponible |
Qu’est-ce qu’un jeton de design ?
Les jetons de design sont des choix de design élémentaires et réutilisables qui constituent le style visuel d’un système de design. Ils remplacent les valeurs statiques par des noms explicites.
Un jeton de design se compose de deux éléments :
- Un nom au format technique, tel que md.ref.palette.secondary90
- Une valeur associée, telle que #E8DEF8
La valeur d’un jeton peut notamment être une couleur, une police de caractères, une dimension ou même un autre jeton.

Les jetons de design établissent un lien explicite entre des choix de style qui, sans eux, n’auraient pas de relation évidente.
Par exemple, si les maquettes d’un designer et l’implémentation d’un développeur font toutes deux référence au même jeton pour la « couleur de conteneur secondaire », on peut être sûr que la même couleur est utilisée des deux côtés. Cela reste vrai même si la valeur hexadécimale attribuée à ce jeton est mise à jour.

Pourquoi les jetons sont-ils importants ?
Les jetons offrent à un système de design une source de vérité unique : un référentiel où les choix de style sont enregistrés et les modifications peuvent être suivies.
Comme ils sont réutilisables et définis par leur usage, les jetons permettent d’appliquer des mises à jour à l’échelle du système pour les thèmes et les contextes. Par exemple, vous pouvez utiliser des jetons pour appliquer une palette de couleurs à contraste élevé à l’échelle du système afin d’améliorer la visibilité, ou modifier l’échelle typographique pour garantir que le texte est lisible sur un écran de télévision.
En utilisant des jetons pour le design et l’implémentation, les mises à jour de style se propagent de manière cohérente dans tout un produit ou une gamme de produits. Ils aident également les designers et les développeurs à « parler le même langage », ce qui réduit la confusion lors du passage du design à l’implémentation.

Déterminer si les jetons vous conviennent
Les jetons seront les plus utiles si :
- Vous prévoyez de faire évoluer le design de votre produit ou de créer un produit à partir de zéro
- Votre système de design est appliqué à une gamme de produits ou de plateformes
- Vous souhaitez faciliter la maintenance ou la mise à jour des styles à l’avenir
- Vous souhaitez tirer le meilleur parti du système Material Design, notamment des fonctionnalités telles que la couleur dynamique
Les jetons seront moins utiles si :
- Vous avez une application existante qui utilise des valeurs codées en dur et qui est peu susceptible de changer dans les deux prochaines années
- Votre produit ne dispose pas d’un système de design
Jetons et Material Design
Par le passé, les styles Material étaient communiqués au moyen de lignes directrices, de fichiers de design, d’outils et de bibliothèques de composants propres à chaque plateforme.
Avec les jetons de design, vous pouvez désormais télécharger, personnaliser et appliquer les styles Material, et les intégrer à l’ensemble de votre processus de design et de développement.
Les jetons permettent de documenter ces décisions dans un format indépendant de la plateforme et partageable.

Sur ce site, les jetons sont présentés dans des modules interactifs.
Ces modules vous permettent de consulter rapidement la valeur de référence par défaut stockée dans les jetons pour la couleur, la police, la taille de police, la graisse de police, etc. Ils montrent également la relation entre un rôle, son jeton système, son jeton de référence et la valeur prédéfinie stockée.

Vous verrez également des jetons dans les onglets de spécifications des articles sur les composants.
Les jetons sont d’abord regroupés par état (activé, désactivé, survolé, etc.), puis par élément, c’est-à-dire la partie du composant à laquelle un jeton ou une valeur s’applique, comme le conteneur ou le libellé.
Les colonnes incluent :
- Nom – L’aspect stylistique du composant auquel le jeton s’applique, comme la couleur ou la police
- ID du jeton – Le jeton définissant l’aspect stylistique du composant
- Description – Informations complémentaires facultatives
- Contexte/valeur – La valeur stockée dans le jeton pour un contexte donné

Comment utiliser les modules de jeton
Imaginons que vous deviez vérifier le rôle de couleur du libellé d’un bouton plein.
Accédez à Boutons courants > Spécifications, trouvez le module de jeton des boutons pleins, puis recherchez les jetons « libellé » dans la section des éléments.
Copiez le jeton de couleur et collez-le dans le code, ou comparez-le au rôle de couleur dans Figma.

Parties d’un nom de jeton
Les parties d’un nom de jeton sont séparées par des points et vont de l’information la plus générale (« md ») à la plus spécifique (« on-secondary »).
- Tous les noms de jetons d’un système de design commencent par le nom du système (par exemple, « md » pour Material Design)
- Une abréviation pour la classe de jetons : « ref » pour les jetons de référence, « sys » pour les jetons système et « comp » pour les jetons de composant
- Le jeton se termine par des mots descriptifs indiquant son rôle

- Indique le système de design
- Indique la classe de jeton
- Indique l’objectif du jeton
Classes de jetons
Il existe trois classes de jetons dans Material :
- Jetons de référence
Tous les jetons disponibles avec leurs valeurs associées. - Jetons système
Décisions et rôles qui définissent l’identité du système de design, de la couleur et de la typographie à l’élévation et à la forme. - Jetons de composant
Les propriétés de design attribuées aux éléments d’un composant, comme la couleur de l’icône d’un bouton.
Avec ces trois classes, les équipes peuvent mettre à jour les décisions de design globalement ou appliquer un changement à un seul composant.

Jetons de référence
Ces jetons représentent toutes les options de style disponibles dans un système de design.
Ils pointent généralement vers une valeur statique – comme un code couleur hexadécimal ou une taille de police – mais peuvent aussi pointer vers d’autres jetons de référence. Les jetons de référence ne changent pas selon le contexte.
Ils fournissent à votre équipe un point de départ composé de couleurs, de typographies et de dimensions approuvées, entre autres.
Tous les jetons de référence commencent par le préfixe ref.

Jetons système
Ce sont les décisions qui systématisent le langage de design pour un thème ou un contexte spécifique.
Les jetons système définissent le rôle qu’un jeton de référence joue dans l’interface utilisateur.
C’est à ce niveau que s’effectue la gestion des thèmes. Un jeton système peut pointer vers différents jetons de référence selon le contexte, comme un thème clair ou sombre.
Dans la mesure du possible, les jetons système doivent pointer vers des jetons de référence plutôt que vers des valeurs statiques.
Tous les jetons système commencent par le préfixe sys.

Jetons de composant (en développement)
Ils représentent les éléments nécessaires à la composition d’un composant — conteneurs, libellés, icônes, états — ainsi que leurs valeurs, telles que la taille, la forme, la couleur ou l’élévation.
Dans la mesure du possible, les jetons de composant doivent pointer vers un jeton système ou un jeton de référence et ne pas contenir de valeurs codées en dur telles que des codes hexadécimaux.
Il n’est pas toujours possible d’exprimer tous les choix stylistiques d’un composant sous forme de jeton ; toutefois, lorsqu’un choix de design s’applique à plusieurs composants de même nature, un jeton doit être utilisé.
Tous les jetons de composant commencent par le préfixe comp.

Contextes
Les jetons peuvent pointer vers différentes valeurs selon un ensemble de conditions. Ces conditions sont appelées contextes, et les valeurs résultantes sont appelées valeurs contextuelles.
Voici quelques exemples de contextes : facteurs de forme des appareils, thème sombre, mises en page denses et systèmes d’écriture de droite à gauche.
Vous pouvez considérer un contexte comme un libellé. Si une valeur de jeton est étiquetée « thème sombre », elle remplace la valeur de jeton par défaut dans un contexte de thème sombre.
