ビジュアルデザイン は何をしますか?
あらゆる画面の背後にあるシステム:色、文字、スペース、シェイプ、奥行き、モーションのトークンと、それらから構築されるコンポーネント仕様。designer スキルはこのシステムを実際のページに適用します。システムを一度構築すれば、ページはそれを活用できます。
最も重要なルール
- トークンを作成する前に、デザインの方向性を言葉で記述します。 3~4文で、誰のためのものか、どんな印象を与えるべきか、絶対に与えてはいけない印象、そしてテーマから借用する要素を1つ記述します。すべてのトークンの決定は、その段落に照らしてチェックされます。
- コンポーネントはセマンティックトークンを参照し、プリミティブを直接参照しません。
--color-text-primaryであって、--grey-900ではありません。ダークモード、テーマ変更、リブランドは、書き換えではなく、マッピングの変更になります。 - すべての実際の組み合わせについて、両方のテーマでコントラストをチェックします。 以下の表を参照してください。白で合格するパレットでも、色付きのサーフェス上では不合格になることがあります。
- デフォルトは決定ではありません。 フレームワークのグレー、すべてにInter、すべてのボックスに4pxの半径:それぞれは問題なく見えますが、組み合わせると他のすべての製品と同じに見えます。各値を決定するか、意図的に受け入れてください。
- すべてのコンポーネント仕様は、すべての状態をリストします。 デフォルト、ホバー、フォーカス、アクティブ、無効、ローディング、エラー、該当する場合は選択済み。状態が欠落していると、ビルド中に一貫性なく発明されます。
- より少ない値を、一貫して使用します。 ランダムに使用される14段階のスケールよりも、どこでも一貫して使用される6段階のスケールの方が優れています。
使用すべきでない場合
- 特定のページの配置、ファーストビューの選択、画面の批評、リデザインの実行:
designer。 - イラスト、アイコン、ヒーローイメージ、ブランドマークの生成:
artist。 - チャートやデータビジュアライゼーションのパレット:
frontendスキルのreferences/charts.md。カテゴリカルチャートの色には、ブランドパレットにはない制約があります。 - フレームワークでのトークンの実装:
frontend。
構築順序
各レイヤーは前のレイヤーに依存します:
- 方向性の段落。
- 色:プリミティブ、次にセマンティックトークン。
- タイポグラフィ:書体、次にスケールと役割。
- スペーシングスケールとグリッド。
- 半径、境界線、および elevation。
- モーショントークン。
- コンポーネントトークンとコンポーネント仕様。
色
構造:
プリミティブ(生の値、色相ごとに1つのランプ、例:50, 100 ... 900, 950):
--blue-600: oklch(0.55 0.17 255)
セマンティックトークン(プリミティブを参照し、役割で命名):
--color-bg, --color-surface, --color-surface-raised
--color-text, --color-text-muted, --color-text-on-accent
--color-accent, --color-accent-hover
--color-border, --color-focus-ring
--color-danger, --color-success, --color-warning (それぞれにテキストセーフなバリアントを伴う)
考慮されたパレットとデフォルトのパレットを分けるルール:
- ランプはOKLCHで構築します。 明度は色相間で知覚的に均一になるため、600の青と600の緑は同じ視覚的重みを持ちます。HSLの明度は誤解を招きます。
- ニュートラルに色味を加えます。 純粋なグレーや純粋な黒、白は、所有感がありません。ブランドの色相に向かって少量のクロマ(約0.005~0.015)を追加します。
- 色付きサーフェス上のテキスト には、そのサーフェスの色相の暗い色合いを使用し、ニュートラルグレーは使用しません。色の上にグレーは、くすんで見えます。
- コミットメントレベルを選択し、それを維持します。 抑制的(ニュートラルな基盤、1つのアクセント)、コミット(ブランド色相が全体に存在)、フルパレット、または染み込んだ(ブランド色相が基盤)。中途半端なコミットメントは優柔不断と読み取られます。
- 色だけで意味を伝えないでください。 アイコン、ラベル、またはパターンと組み合わせてください。
- 現在の反射的な選択に注意してください。 暖かいクリーム色のページにセリフのディスプレイとテラコッタのアクセント、または、ほぼ黒に1つの酸っぱいアクセントは、何も決定されていない場合に生成されたデザインが手を伸ばすものです。方向性の段落がそれらを要求する場合にのみ使用してください。
コントラスト(WCAG 2.2)
| ペア | AA | AAA |
|---|---|---|
| 本文テキスト(ラージテキスト未満) | 4.5:1 | 7:1 |
| ラージテキスト:24pxレギュラー、または約18.7pxボールド以上 | 3:1 | 4.5:1 |
| UIコンポーネントの境界線、アイコン、フォーカスインジケーター、意味を持つチャートマーク | 3:1 | なし |
- ユーザーに何かを伝えるプレースホルダーテキストはテキストです:4.5:1。
- 無効なコントロールは対象外ですが、ユーザーはコントロールが存在することを確認できる必要があります。
- 計算された色(不透明度とオーバーレイを含む)を測定します。色付きカード上の60%不透明度のラベルは、新しい色です。
タイポグラフィ
- 習慣ではなく、コンテンツのレジスターに合わせて書体を選択します。 3つの役割:特徴のあるディスプレイフェイス(控えめに使用)、読みやすいボディフェイス、ラベル、キャプション、データ用のユーティリティフェイス(表の数値用のタブラー図形)。
- 明確なコントラストでペアリングする(セリフとサンセリフ、ジオメトリックとヒューマニスト)か、1つのファミリーをウェイト間で使用します。類似しているが同一ではない2つの書体は、ミスと読まれます。
- モジュラースケール。 1つの比率を選択します:高密度なプロダクトUIには1.2、コンテンツとマーケティングには1.25~1.333。サイズではなく役割に名前を付けます:
display、h1~h4、body-lg、body、body-sm、label、caption。 - メジャー 本文テキストは60~75文字(
max-width: 70ch)。 - ディスプレイタイプ は、よりタイトなトラッキング(約
-0.02em~-0.04em)とサイズ上限(約clamp()で6rem)を設定します。大きすぎると、意図的とは見なされにくくなります。 - 見出しには
text-wrap: balance、本文にはtext-wrap: pretty。 - 行の高さ:本文は約1.5、ディスプレイは1.1~1.25。
スペース、シェイプ、奥行き
- スペーシングスケール は4または8をベースに:例:4、8、12、16、24、32、48、64。コンポーネントは生のピクセル値ではなくトークンを使用します。
- 半径:2つまたは3つの値と、どこに適用するかのルールを設定します。ネストされた半径:内側の半径は、外側の半径からそれらの間のパディングを引いた値に等しくなります。
- Elevation:3つまたは4つのレベルで、それぞれに役割(通常のカード、ドロップダウン、モーダル)を割り当てます。ダークテーマでは、より重い影ではなく、より明るいサーフェスで elevation を上げます。
モーション
- トークン:持続時間(例:120ms、200ms、320ms)と2つまたは3つのイージングカーブ(1つは出現用、よりシャープなものは消通用)。要素はそれらを再利用します。要素ごとに値を選ぶことはありません。
- モーションは変化を説明します:何がどこから来たのか、何が反応したのか。装飾だけのモーションは、生成されたように見えます。
- 1つの振り付けられた瞬間は、すべてが同時にフェードインするよりも優れています。
prefers-reduced-motion: reduceを尊重します:動きと長いトランジションを削除し、不透明度の変更は維持します。- ホバー時に写真を拡大縮小しないでください。コンテナ(影、境界線、背景)をアニメーション化します。
ダークモード
- ダークテーマは、セマンティックトークンの再マッピングであり、決して反転ではありません。基盤には純粋な黒ではなく、ダークグレーを使用し、発光するアクセントのクロマを下げます。
- ダークテーマですべてのコントラストペアを再チェックします。
- 間違ったテーマのフラッシュを防ぎます:最初のペイントの前に、ドキュメントヘッド内の小さなインラインスクリプトでテーマを決定します。
ダークモードでのテーマ切り替え、永続化、画像の実装については、references/dark-mode.md を参照してください。
コンポーネント仕様
コンポーネント仕様を記述する前に、references/component-spec.md を参照してください。テンプレートと状態チェックリストが含まれています。
注意点
- 100から900と名付けられた11段階の色合い。 それは9段階です。カウントと名前が一致するようにランプに名前を付けます(50、100 ... 900、950 は11になります)。
- 「ラージテキスト」は18ポイントを意味し、18ピクセルではありません。 18pxのレギュラー本文テキストには3:1ではなく4.5:1が必要です。ラージテキストのしきい値は、24pxレギュラーまたは約18.7pxボールドです。
- コンポーネント内のプリミティブトークン。 最初のテーマまでは機能します。その後、すべてのコンポーネントを編集する必要があります。
- モックではなく、ビルドでコントラストをチェックします。 不透明度、オーバーレイ、アンチエイリアシングは実際の色を変更します。レンダリングされたピクセルまたは計算されたスタイルを測定します。
- 1つのグローバルな調整でローカルな問題を修正します。 1つの失敗したペアを救うためにパレット全体を暗くすると、他のすべてのペアがずれます。ペアのトークンを修正します。
- 誰も使わないトークン、またはトークン化されていない生の値。 どちらもシステムとビルドが乖離していることを意味します。ビルド内の生の16進数値とピクセル値を grep します。
- 1つの見出しのためにロードされる新しいフォント。 各書体は読み込み時間を要します。システムがすでにロードしている書体を使用します。
検証
- 方向性の段落が記述され、各トークンファミリーがそれに遡れること。
- すべてのテキストとUIのペアが、ライトテーマとダークテーマの両方でAAに合格し、構築されたページ上で測定されていること。
- コンポーネントがセマンティックトークンのみを使用していること:grep でコンポーネントコードに生の色やスペーシングの値が見つからないこと。
- すべてのコンポーネント仕様にすべての状態がリストされていること。
- reduced-motion 設定がテストされ、動きが残っていないこと。
- 反対のシステム設定でハードリロードしたときに、テーマ切り替えでフラッシュが発生しないこと。