デザインシステム は何をしますか?
概要
デザインシステムとは、決定を一度行い、それをあらゆる場所で再利用するための場所です。すべての色はトークンであり、すべてのインタラクティブな要素はすべての状態を表示し、変更はその要素を使用するすべての画面に反映されます。基盤から階層的に構築し、各層で承認を得てから次に進みます。監査はレポートを作成し、自動修正は行いません。
使用するタイミング
- 「…のスタイルガイド/デザインシステム/トークンを開始する」
- コンポーネント、バリアント、またはトークンを追加する、または既存のものを変更する。
- 「これらの画面を一貫させる」、「標準化する」、「ガイドを監査する」、または画面内のばらばらの色や使い捨ての部品。
使用しないタイミング
- 1つの値に関する質問(「主要な色は何ですか?」):その質問に答える。
- 共有部品に対する、ユーザーが正確に記述した小さな編集(1つの値、1つのラベル、1つのサイズ):定義された場所で1回だけ変更し、影響を受ける画面を伝える。状態マトリックスや中断はなし。
開始前
- プロジェクトルートに
DESIGN.mdが存在する場合は読む:それはプロジェクトのデザインブリーフです。 - 既存のものを確認する:トークン、ガイド、コンポーネント、画面、コード。既存のガイドが外観を優先します。 以下のデフォルトと異なる場合でも、そのルールに従い、その違いを一度だけ伝える。
- 使用ツールのアダプターを
references/adapters/から選択する(paper.md、figma.md、html.md)。アダプターがない場合は、ツールで同じアクションを実行し、手動でマッピングしたことを伝える。デザインツールがまったくない場合は、HTML(html.md)で構築する。画像のみしかない場合は、そこから読み取った値は推定値であることを伝える。 - モードを決定する:作成、追加または変更、または監査。
手順 · 作成
-
基盤のドラフト:
- カラーロール(トークンロール)
- タイプスケール
- スペーシング
- 半径
- シャドウ(最大2つ)
- レイアウト幅
- モーション時間
- 短い「執筆方法」セクション
トークンは役割で命名する(
text-muted、border-hover、danger-bg)。値のみで命名しない(gray-500)。 -
インタラクションルール(1回だけ): 枠線ありの要素、枠線なしの要素、プライマリアクションについて、ホバー、プレス、フォーカス(キーボードのみ)、無効、ローディング、選択済みの見た目を記述する。コンポーネントはこれらのルールに従い、独自のルールを発明しない。
-
一時停止し、ユーザーに基盤とインタラクションルールを見せる。 まだコンポーネントを構築しない。
-
最初の画面で必要な順に、コンポーネントを1つずつ処理する。 各コンポーネントは、コンポーネントアナトミーを備えたガイドセクションを持つ:ルールとその理由を示す凡例、例、およびバリアント×状態の状態マトリックス。各コンポーネントをコンポーネントインデックスに追加する。
手順 · 部品の追加または変更
- 既存のコンポーネントとそのバリアントで対応できるか確認する。使い捨てよりも再利用を優先する。
- アナトミーを使用して描画し、完全な状態マトリックスを含める。新しい色、サイズ、アイコンは、後回しにせず、今トークンまたはアイコンセットエントリにする。
- その部品を使用するすべての画面とコードの場所をリストアップする。
- 一時停止し、ユーザーに変更内容とそのリストを見せる。
- 承認後、波及させる:
- リスト上のすべての画面を更新する
- コードがあれば更新する
- コンポーネントインデックスを更新する
- 何がどこで変更されたかを報告する
手順 · 監査
- 監査チェックリストをガイド、画面、コード(ある場合)に対して実行する。
- レポートを作成する:重要度順に並べた発見事項。それぞれに、問題の場所、重要である理由、提案された修正を含める。
- 一時停止し、ユーザーにレポートを見せる。ユーザーがどの修正を行うか指示するまで、ファイルを変更しない。 元のファイルのコピーを保存しても、それらの編集が許容されるわけではない。
ルール
確定的(あらゆるプロジェクト):
| ルール | 理由 |
|---|---|
| すべての色はトークンである;画面やコード内にばらばらの16進数値は禁止 | ばらばらの値はニアデュープに漂流し、誰も一度に変更できなくなる |
| アイコンセットは1つ | 混合セットは混合製品のように見える |
| デザインとコードは同時に変更し、デザインが優先 | そうしないと、1週間以内にガイドが真実でなくなる |
| すべてのインタラクティブな要素には状態マトリックスがある | 画面ごとにアドホックに描画された状態は決して一致しない |
| 共有部品への変更は、波及する前に影響を受ける画面とともにリストアップする | そうしないと、1つの「小さな」変更が20の画面を静かに再デザインする |
デフォルト(既存のガイドがあればそれを優先):
| デフォルト | 理由 |
|---|---|
| ホバー時、枠線ありの要素は枠線のみを暗くする | カードやフィールドの背景が変わると重く感じる |
| ホバーは選択済みよりも控えめにする | ホバーが選択済みのように見えると、2つのものが選択されていると思われる |
| 選択してもフォントの太さは変わらない | 太さが変わるとテキストの幅が変わる |
| プレースホルダーはマutedテキストよりも明るくする | そうしないと、プレースホルダーが入力テキストのように読める |
| 積み重ねリストやメニューのアイテム間には小さな間隔を設け、接触させない | 接触するハイライトが1つのブロックにまとまる |
| フォーカスリングはキーボードからのみ表示する | マウスクリック後のリングはバグのように見える |
| ローディング時は要素の正確なサイズを維持する | レイアウトシフトを防ぐ |
| シャドウはフローティング要素(メニュー、ポップオーバー、ダイアログ、トースト)にのみ、2段階の強度で使用する | シャドウが至る所にあると、作成しようとした階層が平坦になる |
| 1画面につきプライマリアクションは最大1つ | 2つのプライマリは、画面が決定を下していないことを意味する |
完了条件
- 作成: 基盤とインタラクションルールが承認されている。各コンポーネントにアナトミー、状態マトリックス、インデックス行がある。
- 変更: リストアップされたすべての画面とコードの場所が更新され、インデックスが更新されている。
- 監査: 優先順位付けされたレポートが提出され、ファイルは変更されていない。
よくある間違い
| 考え | 現実 |
|---|---|
| 「トークンと10のコンポーネントを一度にガイド全体を構築しよう」 | 承認されていない基盤の上に10のコンポーネントを作ると、10回の作り直しになる。基盤、中断、そしてコンポーネント。 |
| 「監査で問題が見つかったから、すぐに修正しよう」 | ユーザーは修正の半分に同意しないかもしれない。レポート、中断、ユーザーが選んだものだけを修正。 |
| 「元のファイルをバックアップフォルダに保存したから、修正しても安全だ」 | バックアップがあっても、ユーザーが修正に同意するわけではない。まずレポート。 |
| 「ボタンにホバーと無効があれば十分だ」 | 状態マトリックスには、すべての状態×すべてのバリアントが必要:通常、ホバー、プレス、フォーカス、無効、ローディング、選択済み。 |
「--teal-600 はトークンだ」 | それは値です。コンポーネントには役割(--color-primary)が必要で、そうすれば値を1か所で変更できる。 |
| 「この画面には少し異なるカードが必要だ」 | それをカードのバリアントにするか、カードを使用する。使い捨ては漂流の始まりだ。 |