デザイントークン は何をしますか?
名前付きの値の小さなセットをあらゆる場所で使用することで、サイトが「組み立てただけ」ではなく「デザインされた」ように見えます。コンポーネントの前にトークンを定義してください。後でブランドを変更する場合は、1つのブロックを編集するだけですみます。
依頼すべきこと
1つのブランドカラー(またはムードを表す言葉)、ライト/ダークベース、そしてトーン(企業向け、遊び心、エディトリアル、テクニカル)。これ以外はすべて導出可能です。
カラー
色名ではなく「役割」で作業します。これにより、リブランド時に名前の変更が不要になります。
| トークン | 役割 | 目安 |
|---|---|---|
--bg | ページ背景 | オフホワイトまたはほぼ黒。純粋な #fff や #000 は避ける |
--surface | カード、入力フィールド | 明度で --bg から2~4%離す |
--text | 本文テキスト | --bg に対して少なくとも7:1 |
--muted | 二次テキスト | --bg に対して少なくとも4.5:1 |
--border | ヘアライン | テキストカラーを背景に10~15%混ぜる |
--accent | ボタン、ハイライト | ブランドカラー |
--accent-ink | --bg 上のリンクとアクセントテキスト | ブランドカラーを、4.5:1を満たすまで暗く(またはダークモードでは明るく)する |
--on-accent | アクセント上のテキスト | 白または黒のうち、4.5:1を満たす方 |
ガイドライン:
- ニュートラルカラーには、アクセントの色相をわずかに(彩度2~6%)加えてトーンを調整します。暖色系のアクセントの隣に純粋なグレーがあると、関連性が感じられません。
- アクセントカラーは表面積の約10%に使用します。すべてがアクセント色になると、何もアクセントになりません。
- 2つ目のアクセントはほとんど必要ありません。成功やセールなど、明確な意味がある場合にのみ追加してください。
- ダークモードでは、反転させないでください。表面の明度を「高さ」に応じて上げ、アクセントの彩度を少し下げて、光りすぎないようにします。
webcraft CLIが利用可能な場合は、手作業で値を導出する代わりに、初期セットを生成してください。上記のすべてのルールを適用し、各ペアが基準を満たすまで明度を調整し、ダークテーマを個別に構築します:
webcraft tokens "#e4572e" --tone editorial -o tokens.css # オプション: --base dark, --radius pill
webcraft tokens "#e4572e" --format theme-json # 同じ値を持つWordPress theme.json
MCPクライアント内では、同じ処理は generate_tokens ツールです。出力は最初のドラフトとして扱ってください。目視で調整し、再チェックします。
テキストと背景のすべてのペアを、最終決定前にチェックしてください:
webcraft contrast "#1b1b1f" "#f6f4ef"
webcraft contrast --tokens tokens.css
python scripts/contrast.py --tokens tokens.css # インストール不要のフォールバック、16進数値のみ
最初の形式は、1つのペアの比率とWCAGレベルを出力します。2番目の形式はCSSファイルを読み取り、すべてのテーマブロック(:root、[data-theme]、prefers-color-scheme)内の標準的な役割ペアをチェックし、var() を解決して16進数、rgb()、hsl()、oklch()、color-mix() を読み取ります。不合格のペアは、新しいサイトで最もよく見られるアクセシビリティ上の欠陥であり、良好なモニタを使用している視力の良い人には見えないため、これはスクリプトであり、判断に委ねるものではありません。
タイポグラフィ
- 最大2つのファミリー: 1つは見出し用、もう1つは本文用です。多くの場合、1つのファミリーを2つのウェイトで使う方が優れています。
- 構造のコントラストでペアリングします(セリフのディスプレイとサンセリフの本文、またはコンデンスドのディスプレイとレギュラーの本文)。似たようなサンセリフ同士は避けます。
- 本文サイズは16~18px、行間は1.5~1.7、1行の長さは60~75文字にします。
- ディスプレイタイプ: 行間0.95~1.1、サイズが大きくなるにつれてトラッキングをマイナスにします。
clamp()を使用した流体スケールで、ブレークポイント間のジャンプをなくします:
:root {
--step--1: clamp(0.83rem, 0.8rem + 0.15vw, 0.9rem);
--step-0: clamp(1rem, 0.95rem + 0.25vw, 1.125rem);
--step-1: clamp(1.25rem, 1.1rem + 0.6vw, 1.6rem);
--step-2: clamp(1.6rem, 1.3rem + 1.3vw, 2.4rem);
--step-3: clamp(2rem, 1.5rem + 2.6vw, 3.6rem);
--step-4: clamp(2.5rem, 1.6rem + 4.6vw, 5.5rem);
--step-5: clamp(3rem, 1.5rem + 7vw, 7.5rem);
}
- フォントは
font-display: swapで読み込み、ファーストビューで使用する1つまたは2つのファイルをプリロードし、セルフホスティングの場合はサブセット化します。
スペーシング、角丸、シャドウ
:root {
--space-1: 0.25rem; --space-2: 0.5rem; --space-3: 0.75rem; --space-4: 1rem;
--space-6: 1.5rem; --space-8: 2rem; --space-12: 3rem; --space-16: 4rem;
--section: clamp(4rem, 3rem + 6vw, 9rem); /* セクション間の垂直方向のパディング */
--gutter: clamp(1rem, 0.5rem + 3vw, 3rem); /* ページサイドのパディング */
--container: 76rem;
--radius-sm: 8px; --radius: 16px; --radius-lg: 28px; --radius-pill: 999px;
--shadow: 0 1px 2px rgb(0 0 0 / .04), 0 8px 24px rgb(0 0 0 / .06);
}
- 角の性格(シャープ、ソフト、ピル)を1つ選び、それを貫きます。角丸を混在させることは、一貫性がないように見える最も早い方法です。
- セクション間のスペーシングは、セクション内のスペーシングよりも明らかに大きくします。このギャップが、セクションの終わりを目に伝えるものです。
出力
:root ブロック、オプションの [data-theme="dark"] ブロックを含む1つの tokens.css と、各トークンがどこで使用されているかを示す短いテーブルを納品します。その後、本文テキスト、マutedテキスト、ボタンテキストのコントラスト結果を記載します。
既存サイトのリブランド
まず、ハードコードされた既存の値を役割にマッピングします(CSS内の16進数コードを検索して出現回数を数えます)。それらをトークンに置き換え、視覚的に何も変更されていないことを確認してから、トークンの値を交換します。両方を一度に行うと、回帰の追跡が不可能になります。