NAOQ Design Note

デザインとコードの学習ノート

デザイントークンとは?色や余白に名前をつけて共有する仕組み

デザイントークンとは?色や余白に名前をつけて共有する仕組み

デザインの途中でメインカラーを少し変えたくなったのに、ボタンや見出し、アイコンなど色を使った場所を1つずつ探して直すことになり、直し漏れが出てしまった、という経験はありませんか。

こうした手間や直し漏れを防ぐ仕組みが「デザイントークン」です。

この記事では、デザイントークンとは何か、トークンにする値の種類、具体的な値から役割の名前へと段階を分ける考え方、そしてなぜ便利なのかを、見本を使って初心者向けに解説します。

この記事の見本は、サイトの配色ではなく、架空のサービスの配色(青系)で描いています。見本の部品は押しても動きません。

デザイントークンの基本

まずは、デザイントークンとは何か、どんな値をトークンにするのかを押さえましょう。

デザイントークンとは

デザイントークンとは、色・文字の大きさ・余白・角丸など、デザインで繰り返し使う値に名前をつけて、デザインする人と実装する人が同じ名前で使えるようにしたものです。

たとえば、青の#3E5BD8に「color-primary」という名前をつけ、ボタンの色を決めるときは「color-primary」を使う、というように、値ではなく名前で指定します。

デザイントークンの共通の書き方を定めている「Design Tokens Community Group」の仕様では、デザイントークンを「人が読める名前と結びついた情報で、少なくとも名前と値の組」と説明しています(Design Tokens Format Module 2025.10(英語))。

「トークン」は英語で「しるし」や「代わりになるもの」という意味で、値の代わりに使う名前だと考えると分かりやすいでしょう。

クロークでコートを預けると番号札をもらい、あとはその札を見せればコートが出てくるように、#3E5BD8のような覚えにくい値を毎回やり取りする代わりに、「color-primary」という札を使ってやり取りする、というイメージです。

トークンにする値の種類

デザイントークンにするのは、サイトの中で何度も使われ、そろっていてほしい値です。

繰り返し使う値ほど、1か所で管理できるメリットが大きいからです。

よく使われるトークンの種類と、名前の例は次のとおりです。

種類名前の例値の例
色color-primary#3E5BD8
色color-text#1E2533
文字の大きさfont-size-body16px
文字の太さfont-weight-bold700
余白space-m16px
角丸radius-m8px
影shadow-cardカードに付ける影の濃さ・広がり

このほか、行の高さ(行間)や線の太さ、動きの速さなども、トークンにすることがあります。

ポイントは、トークンを「サイトで使ってよい値の一覧」として使い、一覧にない値をその場で作らないようにすることです。

デザイントークンが便利な理由

デザイントークンを使うと、「変更が1か所で済む」「見た目がそろう」「デザインと実装で話が通じる」という3つの良さがあります。

  • 変更が1か所で済む
    トークンの値を書き換えるだけで、そのトークンを使っているすべての場所に変更が反映されます。
    メインカラーを変えたいときも、ボタンや見出しを1つずつ探して直す必要がありません。
  • 見た目がそろう
    値をその場で打ち込まず、決めたトークンから選ぶので、似ているけれど少し違う色や余白が紛れ込みにくくなります。
  • デザインと実装で話が通じる
    デザインする人とコードを書く人が「ここはspace-mで」のように同じ名前で話せるので、数値の伝え間違いが減ります。

次の見本は、同じ「メインカラー」を使うはずの見出しの線・ボタン・ラベルを、値を毎回手で入力した場合と、トークンを使った場合で比べたものです。

新しいプランのお知らせ

新着

詳しく見る

NG:線は#2E4AC0、ラベルは#4F6BE0、ボタンは#3550C8と、手入力で少しずつ違う青になった

新しいプランのお知らせ

新着

詳しく見る

OK:3つともトークン「color-primary」(#3E5BD8)を使い、同じ青にそろった

NGの見本は、1つずつ見ると同じ青に見えますが、並べると線だけ濃く、ラベルだけ薄く、まとまりのない印象になります。

OKの見本は、3つとも同じトークンを使っているので色がそろい、メインカラーを変えたくなったときもトークンの値を1か所直すだけで済みます。

余白の数値に名前をつけて管理する考え方は、余白の間隔のルールとは?でも紹介しています。

デザイントークンの段階と作り方

ここからは、デザイントークンを「具体的な値」と「役割の名前」の段階に分けて整理する考え方と、小さく始める手順を見ていきます。

トークンの段階:具体的な値から役割の名前へ

デザイントークンは、「具体的な値につけた名前」と「使う役割につけた名前」の段階に分けて作るのが一般的です。

値と役割を分けておくと、同じ青を「ボタンの色」にも「見出しの線」にも使いながら、あとで片方の役割だけ別の色に変える、といった変更がしやすくなるからです。

たとえば、ボタンも見出しの線も「blue-500(青の500番)」を直接使っていると、メインカラーを緑に変えたくなったとき、blue-500を使っている場所を1つずつ探して書き換えるか、blue-500の中身を緑にして「名前は青なのに中身は緑」という状態にするしかありません。

間に「color-primary(メインの色)」という役割の名前をはさんでおけば、color-primaryの中身をblue-500から緑の色に付け替えるだけで、メインの色を使っているすべての場所がまとめて変わります。

段階の分け方と呼び方はデザインシステムによって違いますが、よく使われる3段階の例は次のとおりです。

段階何に名前をつけるか名前の例中身
基本のトークン具体的な値そのものblue-500#3E5BD8
役割のトークンサイト全体での使いみちcolor-primaryblue-500
部品のトークン特定の部品の、特定の場所button-primary-backgroundcolor-primary

基本のトークンは「青の500番」のように、色や数値そのものに名前をつけたもので、色の濃さを段階的に並べたパレットなどがこれにあたります(1つの色から濃淡の段階を作る方法はブランドカラーをWebに展開する方法とは?で解説しています)。

役割のトークンは「メインの色」「本文の文字色」のように、何に使うかで名前をつけたもので、中身には基本のトークンを指定します。

部品のトークンは「メインボタンの背景色」のように、特定の部品の特定の場所に名前をつけたもので、中身には役割のトークンを指定します。

このように、あるトークンの中身に別のトークンを指定することを、「参照」や「エイリアス(別名)」と呼びます。

難しく聞こえますが、中身に色の値を書く代わりに「blue-500と同じ」と書いておくだけのことで、blue-500の値を変えれば、それを参照しているcolor-primaryも一緒に変わります。

表計算ソフトで、あるセルに「=A1」と書いておくと、A1の数字を変えたときにそのセルの数字も一緒に変わるのと同じ仕組みです。

たとえば、Googleのデザインシステム「Material Design 3」では、具体的な値を持つ「reference tokens(リファレンストークン)」、役割を表す「system tokens(システムトークン)」、部品ごとの「component tokens(コンポーネントトークン)」の3つに分けています(Material Web「Theming」(英語))。

初心者のうちは、まず「基本」と「役割」の2段階で始め、部品のトークンは必要になってから足すくらいで十分です。

役割の名前が活きる場面

役割のトークンが特に役立つのは、同じ画面を別の色の組み合わせで見せたいときです。

部品が「color-surface(面の色)」「color-text(文字の色)」のような役割の名前で色を指定していれば、役割に結びつける中身を入れ替えるだけで、すべての部品の色が一度に切り替わるからです。

次の見本は、同じカードの役割のトークンの中身を、明るい配色と暗い配色で入れ替えたものです。

定期便の受付を開始しました

毎月決まった日にお届けします。

申し込む
見本A:明るい配色。面の色は白、文字の色は濃い紺

定期便の受付を開始しました

毎月決まった日にお届けします。

申し込む
見本B:暗い配色。役割のトークンの中身だけを入れ替え、カードの作りはそのまま

見本Aと見本Bは、カードの部品としての作りはまったく同じで、「面の色」「文字の色」「補足の文字の色」に結びつけた中身だけを入れ替えています。

もし部品に#FFFFFFのような値を直接書いていたら、暗い配色を作るために部品を1つずつ直す必要がありました。

同じ理由で、トークンの名前は「color-blue」のような見た目ではなく、「color-primary」のような役割でつけるのがおすすめです。

見た目の名前にすると、メインカラーを緑に変えたときに「color-blueの中身が緑」という、名前と中身が食い違った状態になってしまうためです。

デザイントークンを小さく始める手順

デザイントークンは、最初から完璧な一覧を作る必要はなく、今使っている値の整理から小さく始められます。

  1. 今のデザインで使っている色・文字の大きさ・余白・角丸の値を、すべて書き出す
  2. 似ている値をまとめて、使う値を数段階に絞る
  3. 絞った値に、基本のトークンの名前をつける
  4. よく使う役割(メインの色・本文の文字色・面の色など)に、役割のトークンの名前をつけて、中身に基本のトークンを指定する
  5. 名前と中身を表にして、デザインする人・実装する人の両方が見られる場所に置く

デザインツールのFigmaには、塗りの色や余白などの値を名前をつけて保存し、デザイン全体で使い回せる「バリアブル」という機能があり、デザイントークンを管理するときによく使われます(バリアブル、コレクション、モードの概要(Figmaヘルプ))。

バリアブルの具体的な使い方は、Figmaの記事で詳しく扱います。

コーディングでトークンを使う

ここからは、Webサイトを自分でコーディングする人向けの補足です。

デザインツールだけで作る場合は、「値に名前をつけ、役割の名前で指定する」という考え方を押さえておけば十分です。

CSSでは、カスタムプロパティ(CSSの中で使える変数)を使って、トークンの段階を次のように書けます(MDN「CSS カスタムプロパティ(変数)の使用」)。

:root {
  /* 基本のトークン(具体的な値) */
  --blue-500: #3E5BD8;
  --navy-900: #1E2533;
  --white: #FFFFFF;

  /* 役割のトークン(中身は基本のトークン) */
  --color-primary: var(--blue-500);
  --color-on-primary: var(--white); /* 主色の上に乗せる文字の色 */
  --color-text: var(--navy-900);
  --color-surface: var(--white);
}

.button-primary {
  background: var(--color-primary); /* 値ではなく役割の名前で指定 */
  color: var(--color-on-primary);
}

--color-primary: var(--blue-500);は、「color-primaryの中身はblue-500の値を使う」という意味で、表で見た「参照」をCSSで書いたものです。

暗い配色を用意するときは、役割のトークンの中身だけを別の値に入れ替えれば、ボタンなどの部品の書き方は変えずに済みます。

デザイントークンの共通の書き方

デザイントークンには、ツールの間で受け渡しするための共通の書き方(仕様)も作られています。

デザインツールと開発のツールで同じトークンを読み書きできれば、手作業で写す必要がなくなるからです。

W3C(Webの技術の標準を作っている団体)の中にあるコミュニティグループ「Design Tokens Community Group」が、2025年10月に最初の安定版の仕様「Design Tokens Format Module 2025.10」を公開しています(Design Tokens Community Groupの発表(英語))。

この仕様は、トークンをJSON(データを書くための決まった形式)のファイルで書き表す方法を定めたものです。

ただし、仕様の中でも説明されているとおり、これはコミュニティグループの報告書で、W3Cの正式な標準(勧告)ではありません(Design Tokens Format Module 2025.10(英語))。

日本では、デジタル庁デザインシステムがデザイントークンをGitHub(プログラムの公開・共有サービス)で公開し、CSSのファイルなどで配布しています(digital-go-jp/design-tokens(GitHub))。

初心者のうちは仕様の細かい書き方まで覚える必要はなく、「トークンをツール同士で受け渡す共通ルールが整いつつある」と知っておけば十分です。

実践のポイント

デザイントークンを作るときに陥りやすい失敗と、よくある疑問をまとめます。

注意点・よくある間違い

  • トークンを作ったのに、急いでいるときに値を直接入力してしまうことがあります。
    一度でも直接入力すると、トークンを変えてもその場所だけ変わらず、直し漏れの原因になります。
  • 「color-blue」「space-16」のように、見た目や数値そのものを役割のトークンの名前にしてしまうことがあります。
    役割のトークンは「color-primary」「space-m」のように使いみちで名前をつけ、中身が変わっても名前が食い違わないようにしましょう。
  • 最初から部品のトークンまで細かく作りすぎて、どれを使えばいいか自分でも分からなくなることがあります。
    まずは基本と役割の2段階で始め、必要になってから増やしましょう。
  • 名前のつけ方がトークンごとにばらばらになることがあります。
    「種類-役割-段階」のように、名前の並べ方の決まりを先に決めておきましょう。

よくある質問

  • Q. デザイントークンとCSSの変数は同じもの?
    A. 同じではありません。
    デザイントークンは「値に名前をつけて共有する」という考え方や仕組みのことで、CSSのカスタムプロパティは、それをWebサイトで使うための書き方の1つです。
    同じトークンを、Figmaではバリアブルとして、アプリではそれぞれの開発言語の形で使うこともあります。
  • Q. 1人で作る小さなサイトでも、デザイントークンは必要?
    A. 大がかりな仕組みは必要ありませんが、色と余白だけでも名前をつけて表にしておくと、あとで変更するときに役立ちます。
    たとえば、メインの色・文字の色・背景の色など数色と、余白の3〜4段階に名前をつけて、メモやFigmaの画面の端に書き出しておくだけで十分です。
    コーディングもするなら、CSSの冒頭(:root)にカスタムプロパティとしてまとめておきましょう。部品のトークンやJSONのファイルまで用意する必要はありません。
    数か月後の自分にとっても、「どの値を使えばいいか」がすぐ分かる手がかりになります。
  • Q. スタイルガイドやデザインシステムとはどう違うの?
    A. スタイルガイドやデザインシステムは、色・文字・部品の使い方などをまとめた「ルール全体」です。
    デザイントークンはその中で、色や余白などの値を名前で管理する部分にあたります。
    デザインシステムの全体像はデザインシステムの記事で紹介しています。

まとめ

デザイントークンとは、色・文字の大きさ・余白・角丸などの値に名前をつけ、デザインする人と実装する人が同じ名前で使えるようにしたものです。

具体的な値につけた「基本のトークン」と、使いみちにつけた「役割のトークン」に段階を分けておくと、変更が1か所で済み、見た目もそろいやすくなります。

まずは自分のデザインで使っている色をすべて書き出し、似ている色をまとめて、「メインの色」「本文の文字色」などの役割の名前をつけてみてください。