Nommage des jetons et architecture de jetons par niveaux
Structurez vos jetons de conception dans une architecture par niveaux évolutive — jetons primitifs, sémantiques et de composants — avec un nommage qui résiste aux changements.
Nommage des jetons et architecture de jetons par niveaux est une leçon Design Systems & Component Libraries gratuite sur CoddyKit. Ceci est la leçon 4 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Design Systems & Component Libraries, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Design Systems & Component Libraries comprend 4 leçons au total.
Certaines parties de cette leçon n'ont pas encore été traduites et s'affichent en anglais.
Why Token Architecture Matters
A flat list of color tokens works at first, then collapses as the system grows. A tiered token architecture keeps tokens scalable and meaningful.
This lesson builds on implementing tokens by structuring and naming them well.
Tier 1: Primitive Tokens
Primitive (or global) tokens are raw values: blue-500 = #3b82f6, space-4 = 16px.
They are the full palette of available values, named by what they are, with no opinion about where they are used.
Tier 2: Semantic Tokens
Semantic (or alias) tokens describe intent: color-action-primary, color-text-danger.
They reference primitives but add meaning. Components use semantic tokens, so re-theming means repointing aliases, not editing every component.
Tier 3: Component Tokens
Component tokens scope values to a specific component: button-background-color, card-padding.
They reference semantic tokens. The chain below shows the three tiers resolving down to a raw value.
const primitive = { 'blue-500': '#3b82f6' };
const semantic = { 'color-action-primary': 'blue-500' };
const component = { 'button-bg': 'color-action-primary' };
function resolve(token) {
let v = component[token] || semantic[token] || token;
v = semantic[v] || v;
return primitive[v] || v;
}
console.log(resolve('button-bg'));The Power of Indirection
Why three tiers? Indirection. Change color-action-primary from blue to green once, and every button, link, and focus ring updates.
Without semantic tokens you would hunt down every hardcoded blue. Tiers turn sweeping changes into one edit.
Naming That Survives Change
Name semantic tokens by role, never by value. color-success survives a palette change; color-green becomes a lie.
The same rule applies to primitives - prefer blue-500 over brand-blue if the brand might shift.
A Consistent Naming Schema
Adopt a predictable pattern: category-property-variant-state, e.g. color-text-link-hover.
When every token follows the same grammar, developers can guess token names instead of searching docs. Consistency is the goal.
Avoiding Over-Tokenization
Not everything needs a token. Tokenizing every one-off value creates noise and maintenance burden.
Tokenize values that repeat or carry meaning. A truly unique magic number can stay inline with a comment.
Themes Live at the Semantic Tier
Light, dark, and brand themes differ at the semantic layer. Primitives stay constant; semantic aliases repoint per theme.
This is why the tier structure makes multi-theme support nearly free - you swap one mapping table.
Documenting the Hierarchy
Show the token chain in your docs: which primitive a semantic token points to, and which components consume it.
This transparency helps contributors choose the right tier and understand the ripple effect of a change.
Architecture That Scales
A tiered, well-named token system scales from one product to dozens of themed, white-labeled apps without rework.
The structure is the difference between tokens that empower and tokens that become technical debt.
Quick Check
Test your token architecture knowledge.
Recap
You structured design tokens into a scalable architecture:
- Primitive tokens hold raw values.
- Semantic tokens add intent; components reference these.
- Component tokens scope values per component.
- Name by role, follow a consistent schema, and avoid over-tokenizing.
Tiered tokens make sweeping design changes a single edit.
Questions Fréquemment Posées
La leçon « Nommage des jetons et architecture de jetons par niveaux » est-elle gratuite ?
Oui — le texte complet de « Nommage des jetons et architecture de jetons par niveaux » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Design Systems & Component Libraries, passe à CoddyKit PRO. Le cours Design Systems & Component Libraries comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Nommage des jetons et architecture de jetons par niveaux » ?
Structurez vos jetons de conception dans une architecture par niveaux évolutive — jetons primitifs, sémantiques et de composants — avec un nommage qui résiste aux changements. Tu pratiques Design Systems & Component Libraries avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Design Systems & Component Libraries ?
Aucune expérience préalable n'est requise. Design Systems & Component Libraries sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 4 sur 4.
Combien de temps prend la leçon « Nommage des jetons et architecture de jetons par niveaux » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Design Systems & Component Libraries ?
Oui. Chaque leçon Design Systems & Component Libraries inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Que sont les jetons de conception ?
- Mettre en œuvre les jetons de conception
- Automatiser les processus de la conception au code
- Nommage des jetons et architecture de jetons par niveaux