デザイントークン:概要
デザイントークンは、UI のすべての要素を構成する基本単位です。同じトークンがデザイン、ツール、コードで使用されます。
- トークンは、色、フォント、寸法などのスタイル値を参照します
- ハードコードされた値の代わりに、デザイントークンを使用します
- 各トークンは、用途や使用場所に基づいて命名されます(例:md.comp.fab.primary.container.color は FAB のコンテナ色を定義します)
- トークンの最終値が変更されても、名前と用途は変わりません
- Material Design には 3 つのトークンクラスがあります:参照、システム、コンポーネント

リソース
| 種類 | リンク | ステータス |
|---|---|---|
| デザイン | デザインキット(Figma) | 利用可能 |
| Material Theme Builder Figma プラグイン | 利用可能 | |
| 実装 | Material ベースラインテーマとトークン(DSP) | 利用可能 |
デザイントークンとは?
デザイントークンは、デザインシステムの視覚スタイルを構成する、小さく再利用可能なデザイン上の決定事項です。トークンは静的な値を、自己説明的な名前に置き換えます。
デザイントークンは 2 つの要素で構成されます:
- md.ref.palette.secondary90 のようなコード形式の名前
- #E8DEF8 のような関連付けられた値
トークンの値は、色、書体、寸法、さらには別のトークンなど、いくつかのいずれかになります。

デザイントークンは、一見すると関連のないスタイルの選択肢を意味的に関連付けます。
たとえば、デザイナーのモックアップとエンジニアの実装がどちらも「secondary container color」に同じトークンを使用していれば、両方で同じ色が使われていることを確信できます。トークンに割り当てられた 16 進数値が更新された場合も同様です。

トークンはなぜ重要ですか?
トークンにより、デザインシステムに信頼できる唯一の情報源(Single Source of Truth)を設けられます。これは、スタイルの選択を記録し、変更を追跡できるリポジトリです。
トークンは再利用可能で、目的が明確に定義されているため、テーマやコンテキストに対するシステム全体の更新を定義できます。たとえば、トークンを使用して、視認性を高める高コントラストのカラーパレットを体系的に適用したり、テレビ画面でもテキストが読みやすいようにタイポグラフィスケールを変更したりできます。
デザインと実装の両方でトークンを使用すると、スタイルの更新をプロダクト全体または複数のプロダクトに一貫して反映できます。また、デザイナーとエンジニアが共通の言葉で連携できるため、デザインから実装への引き継ぎ時の混乱を減らせます。

トークンが自分に適しているかどうかの判断
次の場合にトークンが最も役立ちます:
- プロダクトのデザインを更新する予定がある、またはプロダクトをゼロから構築している
- デザインシステムが複数のプロダクトやプラットフォームに適用されている
- 将来的にスタイルの保守や更新を容易にしたい
- ダイナミックカラーなどの機能を含め、Material Design システムを最大限に活用したい
次の場合、トークンの有用性は低くなります:
- ハードコードされた値を使用する既存アプリがあり、今後 1~2 年で変更される可能性が低い
- プロダクトにデザインシステムがない
トークンと Material Design
これまで、Material のスタイルは、ガイドライン、デザインファイル、ツール、プラットフォーム固有のコンポーネントライブラリを通じて共有されてきました。
デザイントークンを使用すると、Material のスタイルをダウンロード、カスタマイズ、適用して、デザインと開発のプロセス全体に統合できます。
トークンを使用すると、デザイン上の決定事項を、プラットフォームに依存せず共有可能な形式で文書化できます。

このサイトでは、トークンがインタラクティブなモジュールに一覧表示されます。
これらのモジュールでは、色、フォント、フォントサイズ、フォントウェイトなどについて、トークンに定義されたデフォルトのベースライン値をすばやく確認できます。また、役割(カラーロールなど)と、対応するシステムトークン、参照トークン、プリセット値との関係も確認できます。

コンポーネントのページにある「Specs」タブにもトークンが表示されます。
トークンはまず 状態(有効、無効、ホバーなど)でグループ化され、次に 要素 でグループ化されます。要素とは、コンテナやラベルテキストなど、トークンまたは値が適用されるコンポーネントの構成部分です。
列の項目は次のとおりです:
- 名前 – トークンが適用されるコンポーネントのスタイル項目(色やフォントなど)
- トークン ID – コンポーネントのスタイル項目を定義するトークン
- 説明 – 任意の補足情報
- コンテキスト/値 – 特定のコンテキストにおけるトークンの値

トークンモジュールの使用方法
塗りつぶしボタンのラベルテキストに適用されるカラーロールを確認する必要があるとします。
「Common buttons」>「Specs」に移動し、塗りつぶしボタンのトークンモジュールで、要素の下にある「label text」トークンを探します。
カラートークンをコピーしてコードに貼り付けるか、Figma のカラーロールと比較します。

トークン名の構成要素
トークン名の各部分はピリオドで区切られ、最も一般的な情報(「md」)から最も具体的な情報(「on-secondary」)へと続きます。
- デザインシステムのトークン名はすべて、システム名(例:Material Design なら「md」)で始まります
- トークンクラスを示す略語が続きます:参照トークンは「ref」、システムトークンは「sys」、コンポーネントトークンは「comp」
- トークン名は、その役割を表す説明的な単語で終わります

- デザインシステムを示す
- トークンクラスを示す
- トークンの目的を示す
トークンのクラス
Material には 3 つのトークンクラスがあります:
- 参照トークン
利用可能なすべてのトークンと、それに関連付けられた値。 - システムトークン
色やタイポグラフィからエレベーションや形状まで、デザインシステムの特徴を定義する決定事項とロール。 - コンポーネントトークン
ボタンアイコンの色など、コンポーネント内の要素に割り当てられたデザインプロパティ。
3 つのトークンクラスにより、チームはデザイン上の決定をグローバルに更新したり、単一のコンポーネントに変更を適用したりできます。

参照トークン
これらのトークンは、デザインシステムで利用可能なすべてのスタイルオプションを構成します。
通常は色の 16 進数コードやフォントサイズなどの静的な値を参照しますが、別の参照トークンを参照することもあります。参照トークンはコンテキストによって変化しません。
参照トークンは選択肢の一覧を提供し、承認済みの色、タイポグラフィ、寸法などを選ぶ際の出発点となります。
すべての参照トークンは接頭辞 ref で始まります。

システムトークン
これらは、特定のテーマやコンテキストに合わせてデザイン言語を体系化するための決定事項です。
システムトークンは、参照トークンが UI 内で果たす役割を定義します。
テーマ設定はここで行われます。システムトークンは、ライトテーマやダークテーマなどのコンテキストに応じて、異なる参照トークンを参照できます。
可能な限り、システムトークンは静的な値ではなく参照トークンを参照すべきです。
すべてのシステムトークンは接頭辞 sys で始まります。

コンポーネントトークン(開発中)
コンポーネントトークンは、コンテナ、ラベルテキスト、アイコン、状態など、コンポーネントを構成する要素と、サイズ、形状、色、エレベーションなどの値を表します。
可能な限り、コンポーネントトークンはシステムトークンまたは参照トークンを参照すべきであり、16 進数コードなどのハードコードされた値は含めるべきではありません。
コンポーネントのスタイル上の選択肢すべてをトークンで表現できるわけではありませんが、同様の目的を持つ複数のコンポーネントにデザイン上の選択を適用する場合は、トークンを使用すべきです。
すべてのコンポーネントトークンは接頭辞 comp で始まります。

コンテキスト
トークンは、一連の条件に応じて異なる値を参照できます。これらの条件をコンテキスト、その結果得られる値をコンテキスト値と呼びます。
異なるコンテキストの例には、デバイスのフォームファクタ、ダークテーマ、高密度レイアウト、右から左への書字方向(RTL)などがあります。
コンテキストは一種のタグと考えることができます。トークン値にダークテーマのタグが付いている場合、ダークテーマのコンテキストでは、その値がデフォルトのトークン値を上書きします。
