トークンの命名と階層型トークンアーキテクチャ
デザイントークンをプリミティブ、セマンティック、コンポーネントの各トークンからなる、拡張可能な階層型アーキテクチャに整理し、変更に耐えられる命名方法を身につけます。
「トークンの命名と階層型トークンアーキテクチャ」はCoddyKit上の無料Design Systems & Component Librariesレッスンです。 これはレッスン4/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはDesign Systems & Component Libraries学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 Design Systems & Component Librariesコースには全4レッスンが含まれています。
このレッスンの一部はまだ翻訳されておらず、英語で表示されています。
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.
AI チューターと学ぶ Design Systems & Component Libraries — 無料
ブラウザでリアルコードを書いて実行し、24/7 の AI チューターから瞬時にサポートを受け、ウェブまたはアプリで続きから学習できます。
- コース
- 12
- レッスン
- 48
よくある質問
「トークンの命名と階層型トークンアーキテクチャ」レッスンは無料ですか？
はい。「トークンの命名と階層型トークンアーキテクチャ」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、Design Systems & Component Librariesコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 Design Systems & Component Librariesコースには全4レッスンが含まれています。
「トークンの命名と階層型トークンアーキテクチャ」で何を学びますか？
デザイントークンをプリミティブ、セマンティック、コンポーネントの各トークンからなる、拡張可能な階層型アーキテクチャに整理し、変更に耐えられる命名方法を身につけます。 ブラウザで直接実行するハンズオンコードでDesign Systems & Component Librariesを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。
Design Systems & Component Librariesを始めるのに経験は必要ですか？
事前経験は必要ありません。CoddyKitのDesign Systems & Component Librariesは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン4/4です。
「トークンの命名と階層型トークンアーキテクチャ」レッスンにはどのくらい時間がかかりますか？
ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。
このDesign Systems & Component Librariesレッスンでコードを書いて実行できますか？
はい。すべてのDesign Systems & Component Librariesレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。
このコースのすべてのレッスン
- デザイン・トークンとは
- デザイン・トークンの実装
- デザインからコードへのワークフロー自動化
- トークンの命名と階層型トークンアーキテクチャ