デザイントークン: ブランドの表現を、新しい画面でも使い続けられるルールへ
色、余白、タイポグラフィの役割に名前を付け、デザインの決定をサイト上の要素の変更までつなげる方法を紹介します。
記事の言語: 日本語

目次
「この赤、少し赤すぎますね」。プロジェクトの初期なら、よく分かる意見です。でも20画面を実装した後では、何を指すのか分からなくなります。ブランドカラーなのか、フォームのエラー色なのか、販促エリアの背景なのか、削除ボタンの枠線なのか。1つの値を変えた結果、ある画面は良くなっても、まったく別の理由で同じ値を使っていた3画面が崩れることもあります。
デザイントークンは、色、余白、テキストスタイルなど、繰り返し使う決定に名前を付けたものです。名前が役割を表していると、特に役立ちます。「エラーテキスト」なら、どこに使う値かが分かります。「赤3番」から主に分かるのは、先に別の赤が2つ選ばれていたことです。
最初から大規模なシステムを作る必要はありません。成長中のサイトなら、デザイナーと開発者が理解できる小さな決定の集まりから始められます。何を、なぜ変えるのか、変更後にどこを確認するのかを答えられることが大切です。関係性のない値の一覧は、混乱を少しきれいに保管する方法にとどまりかねません。
値を選ぶ前に役割に名前を付ける
架空のアトリエ用品店を考えてみましょう。ブランドは深い赤をアクセントに使い、住所の入力エラーにも似た色が使われています。最初はどちらも問題なく見えます。ところがブランドカラーを変更すると、読みやすさを変える判断を誰もしていないのに、エラーメッセージも新しい色になります。
原因は、異なる役割に同じ値を使ったことです。最初は同じ色でも、ブランドのアクセントとエラーテキストには別々の名前を付けられます。そうすれば、後から必ず両方を変更する必要はありません。関連付けを維持するかどうかは、スタイルシート上の偶然ではなく、意図したルールで決めます。
元の値、その役割、具体的な要素での使い方を区別しましょう。元の値は色合い、役割は「エラーメッセージのテキスト」、要素は住所欄の下にある文字です。すべてのプロジェクトで、すべての属性に3段階の名前が必要なわけではありません。ただし依存関係を結ぶ前に、その違いを理解しておくと役立ちます。
Design Tokens Format Module 2025.10では、エイリアスは別のトークンの値を参照するものです。この報告書は、参照によって意味上の関係を作る方法も説明しています。判断を関連付ける技術的な土台にはなりますが、ブランドに適した名前や配色を代わりに選んではくれません。
この例では、作業上の名前それぞれに役割と変更後の確認範囲を付けます。
- ブランドアクセントは販促コンテンツを目立たせます。変更後は見出し、リンク、オファーの強調部分を確認します。
- エラーテキストは入力欄の問題を説明します。背景に対してメッセージが読みやすいか確認します。
- エラーの枠線は入力欄と問題を結び付けます。入力欄の状態と周囲の表示を確認します。
- 入力欄とエラーの間隔はコントロールと案内文の関係を定めます。長い文章や拡大表示を確認します。
これは話し合いを整理するための案であり、コードにそのままコピーする名前の一覧ではありません。開発者は別の書き方を選んでも構いません。両方の名前が同じ役割を指し、サイト上の対応する要素を特定できることが必要です。
現在の位置だけでトークンに名前を付けるのは避けましょう。「左側のテキスト」はレイアウトや言語が変わるとすぐに意味を失います。共通の役割を担うものを、1つの画面だけにちなんで名付けるのも避けます。要素が移動しても通用し、かつ何にでも当てはまるほど曖昧ではない名前が必要です。
1つの変更を、判断から画面まで追う
チームがエラーメッセージと装飾的なブランドアクセントを、もっと明確に区別したいとします。まず理由を定めます。フォームに入力する人が説明と入力欄を容易に結び付けられ、販促の見出しが警告に見えないようにするためです。その後で、それぞれの役割に使う値を選びます。
デザイナーはエラーテキスト、入力欄の枠線、その間隔を指定します。開発者は、それらの決定をどの要素が使っているかを調べます。ここで直接入力された色や古い個別スタイルが見つかるかもしれません。システムの外に残したままだと、変更は表面上だけ完了します。新しいカードは正しく表示されても、古いフォームには別の視覚表現が残ります。
偶然同じ値を使っている要素も確認しましょう。見た目が良かったという理由で、エラーの枠線が販促カードに使われていたかもしれません。その枠線が実際にどの役割を果たすのかを判断します。名前のない例外をさらに追加して済ませないでください。例外もデザイン上の決定であり、理由が必要です。
変更後は、具体的な状態を確認します。空の入力欄、長すぎる値、入力内容の修正、再送信です。テキストは入力欄の近くに収まりますか。枠線がキーボードフォーカスの表示と視覚的に競合していませんか。メッセージが早く消えすぎませんか。トークンは値を整理しますが、要素全体の動作テストの代わりにはなりません。
影響を調べる際は、普段あまり見ない場所も選びます。展開したメニュー、検索結果がないときのメッセージ、複数のエラーが起きた後のフォームなどです。共通の役割でも、周囲の要素が異なることがあります。白い面で問題のない色も、独自の背景を持つパネルで確認する必要があります。名前は場所を見つける助けになりますが、評価には該当する画面の状態を実際に開く必要があります。
アイコンにも役割があります。サイトのアイコンの意味とラベルは、操作部品が何を伝えるかを左右します。トークンは状態の色やテキストとの間隔を維持できますが、適切な名前なしに意味の分からない絵を理解可能にはできません。この背景はアイコンの意味と名前の記事 (ポーランド語)でも扱っています。

エラーのない通常状態も確認します。1つのメッセージに関する変更でも、共通の余白を変えると、すべての入力欄の高さに影響することがあります。確認範囲には、判断を行った画面だけでなく、その役割を使う場所を含めます。
Aeneia Designのサービスでは、共通の視覚ルールはサイトを継続的に改善する助けになることがあります。作業前に、どの要素をセットとして管理し、その後の使用を誰が担うのかを決めておきましょう。
システムは画面の見本だけでなく、さまざまな条件で機能する
AtlassianのForge向けドキュメントは、色、余白、タイポグラフィのトークンとアプリのテーマとの関係を示しています。これは特定の環境での実装例であり、別のテンプレートが同じライブラリと自動的に互換になるという意味ではありません。
企業サイトでは、実際に存在する表示の種類から確認します。ライト表示とダーク表示がある場合、同じテキストの役割でも背景に応じて異なる値が必要になることがあります。企業サイトのダークモードを、いくつかの色を反転するだけの作業にしないでください。コンテンツ、面、枠線、状態の関係を確認します。関連する進め方はダークモードの導入と確認の記事 (ポーランド語)を参照してください。
複数の製品群やサービス群を持つブランドでは、共通の役割と個別の特徴を分けます。製品群ごとにアクセントカラーが変わっても、エラーテキストの性格まで変える必要はありません。ブランド構造と製品名では、まず提供内容の関係を明確にします。視覚システムはその関係を表すものであり、独自に新しい分類を作るものではありません。関連する視点はブランドと提供内容の名前の関係の記事 (ポーランド語)でも説明しています。
目に見える余白ごとに、繰り返し使われるかを確認せず別のトークンを作るのは避けましょう。必要なのは、ラベルと入力欄の間、入力欄同士の間、セクション間といった、見分けられるいくつかの関係です。名前には採用した余白のスケールと役割を反映できます。ほぼ同じ値が100個あると、ルールがない場合と同じくらい判断が難しくなります。
タイポグラフィにも同じような規律が必要です。見出しスタイルには大きさだけでなく、使い方、余白、長い文章での振る舞いも含まれます。サイトのタイポグラフィシステムでは、文章が変わっても階層を保つ必要があります。見本に収まらなかったというだけで、1つの見出しを小さくするためにトークンを使うべきではありません。システムにデータが含まれるなら、パレットから適当にアクセント色を割り当てるのではなく、ブランドのグラフにおける色、ラベル、目盛りの役割も定めましょう。関連する問いはサイトのタイポグラフィの記事 (ポーランド語)で紹介しています。ブランドに合わせたグラフ表現の記事 (ポーランド語)も参考になります。
例外が妥当な場合もあります。キャンペーンに独自のアクセントを使ったり、特別なモジュールに異なる余白のリズムを与えたりできます。例外の範囲と共通ルールとの関係を記録します。そうすれば、1つのイベント向けに作った解決策を次の画面が偶然引き継ぐことを防げます。長く残る例外には、誰も一時的だと呼ばなかったものが少なくありません。
ショップの取引に関する通知では、共通の役割がブランドらしさの維持に役立ちますが、技術的な使い方は別途確認する必要があります。同じデザインでも、メールテンプレートとウェブページでは異なる準備が必要な場合があります。視覚的な原則は共通でも、値を届ける方法は環境によって変わります。ショップの取引通知に関する記事 (ポーランド語)では、情報の視覚的な優先順位が次の行動をどう支えるかを扱います。
小さくても、実際に使うセットから始める
サイトがすでに稼働しているなら、すべてのコンポーネントを一度に書き直す必要はありません。実際に拡張中の領域や問題のある領域を選びます。オファーカードの一群、フォーム、ナビゲーションなどです。現在の値を書き出し、役割に名前を付け、どの違いが意図的なのかを決めます。整理する順序はその後で決めます。
移行時には、古い名前と新しい名前の対応表を残します。古いスタイルを廃止する場合は、代替と確認が必要な場所を示します。名前を削除するだけでは、公開後に初めて問題が明らかになることがあります。開発者が変更の意図を理解できる文書が必要です。
現在有効な決定の参照元を1つに定めるか、明確な同期手順を決めます。デザインとコードは異なるツールを使っていても構いません。ただし同じルールの異なる版を、差を示さないまま何週間も維持すべきではありません。そうしないと、同じデザインを確認しているつもりで、食い違う資料について議論することになります。
新しい必要を伝える方法も決めます。編集者は、新しいカードの説明文が読みにくいと伝えるためにトークンの書き方を知る必要はありません。ただし、アドレス、文章の例、問題の説明を誰に送ればよいかは知っているべきです。担当者は、新しい役割、共通の値の修正、個別コンポーネントの修正のどれが必要かを判断できます。ルールを変える窓口がないために、利用者がその場しのぎの対応を作ることを防げます。
新しい値には短い理由を付けましょう。「パネルと背景をもっと区別する必要がある」なら評価の根拠になります。「この見本では良く見えた」は話し合いの出発点にはなっても、共通ルールの理由としては不十分です。新しい役割をどこに使えるかも記録し、あらゆる曖昧な問題への万能策にしないようにします。
トークンの数で完成度を判断してはいけません。小さなサイトなら、誰も使い方を知らない大量の名前より、適切に使われる20個の決定のほうが良い出発点になることがあります。プロジェクトの全履歴をたどり直さなくても、次の変更を行えるセットを目指します。
確認時には、デザイナーと開発者に同じ要素とその役割を示してもらいましょう。次に1つの変更を選び、影響を追います。何が変わったか、どこを確認するか、なぜ他の場所は対象外なのかを両者が説明できれば、そのセットは機能し始めています。整った値のファイルを見せるよりも具体的なテストです。
決定の責任者も決めておきます。トークンが自分で秩序を維持するわけではありません。要素の役割を理解し、変更理由を記録するチームが秩序を保つのを助けます。そうすれば「少し赤すぎる赤」という意見も、すべての画面を巡る作業ではなく、短く検証できる修正になります。








