Tokens de design
Chaque projet conserve ses couleurs, sa typographie et ses espacements sous forme de tokens de design et les sert depuis l'API. Une app qui les lit à l'exécution reflète un changement d'identité de marque dès que les nouveaux tokens sont publiés.
Un document de tokens par projet
Les tokens forment un seul document au format W3C Design Tokens. Chaque token est une valeur nommée, comme color.brand.primary. Les types sont les couleurs, les familles de polices, les graisses, les tailles de police, les hauteurs de ligne, l'espacement des lettres, la typographie composite, les espacements, les rayons de coins, les ombres et les bordures. Les boutons, les cartes, les grilles de mise en page, les points de rupture et les animations n'en font pas partie.
Références entre tokens
Un token peut en référencer un autre par son chemin : modifier une valeur met donc à jour tout ce qui y renvoie. Les références sont résolues sur le serveur avant que les tokens soient servis. Un document avec un cycle de références, une référence inconnue, une incohérence de type ou un type non pris en charge est refusé à la sauvegarde, et l'erreur nomme le chemin du token.
Brouillon et publié
Une modification va dans un brouillon, que vous la fassiez dans la console, sous designTokens dans votre fichier de config ou par l'API. Le site en production continue de servir le dernier ensemble publié jusqu'à ce qu'une publication publie le brouillon. Pour prévisualiser des tokens non publiés, une requête envoie l'en-tête du canal de brouillon avec une clé qui détient la portée de lecture des brouillons.
Lire les tokens dans votre app
La requête GraphQL renvoie des tableaux plats et résolus pour chaque type de token, ainsi que source, le document W3C brut destiné aux outils de build. Une app qui lit les tokens depuis l'API à l'exécution récupère un changement publié sans déploiement. Une app qui les intègre au moment du build doit encore être reconstruite.
Lire le détail
Le guide des tokens de design couvre les types de tokens, les moyens de les modifier et la façon dont le brouillon est publié.