UIデザイン:インターフェース構築のためのルール
このルールは、Michael Filipiuk著『UI Design Principles』(2021年版)から抽出されたものです。このファイルには、すべての画面に適用されるルールが記載されています。references/(このファイルと同じディレクトリ)には、トピックごとに1ファイルずつ詳細が格納されています。タスクに関係するファイルだけを読んでください。
タグのないルールは同書からの引用です。(WCAG) は、同書に記載されていないアクセシビリティ基準を示します。(convention) は、不足を補うために追加された一般的な業界慣習値を示します。(derived) は、同書の独自手法で計算された値を示します。同書の1 pt = 1 CSS px = 1 iOS pt = 1 Android dpです。
リポジトリのデザインシステムを優先する
リポジトリに既存のトークンやテーマ(Tailwind設定、CSS変数、shadcn/MUIテーマ、components/ui/ライブラリなど)が存在する場合は、それらを使用してください。このスキルは、それらが定義していない部分のみを補完します。
- リポジトリ独自のトークンの横に、第二のトークンセットを導入しないでください。
- 並列的なコンポーネントを新たに作るよりも、既存のコンポーネントを再利用してください。
- リポジトリ自体が以下のルールのいずれかを破っている場合(コントラスト不足、32pxのボタンなど)、リポジトリの値を保持し、その競合を報告してください。黙って上書きしないでください。
ルールが競合する場合の優先順位: ユーザビリティ > アクセシビリティ > 一貫性 > シンプルさ > 見た目
クイックパス
- まずは性格を決める: ブランドとオーディエンスに基づいて、遊び心がある、ニュートラル、またはシリアスから選択(
references/personality-and-copy.md)。自分の好みは絶対に入れない。 - 画面より先にトークン: リポジトリのもの、または
references/tokens.mdから、色、タイプスケール、スペーシングスケールを取得。それ以外は使用しない。 - まずはグレースケールで: 階層、レイアウト、スペーシングを正しく設定してから、役割のある箇所にのみ色を追加する。
- すべての状態を持つコンポーネント(デフォルト、ホバー、プレス、フォーカス、無効、エラー、成功)、およびすべての画面状態(空、ローディング、エラー、404)。
- 完了を報告する前に: 自分が構築したものに対して
references/checklist.mdを確認。スクリーンショット可能な場合は、コードではなくスクリーンショットでチェックする。
非妥協ルール
- スペーシングはスケールから取得する。 モバイルでは4ptスケール、Webでは8ptスケールを使用する。5、13、22 pxなどの値は使用しない。
- ボディテキストは16~17 px。 いかなるテキストも10 px未満にしてはならず、12 px以上を推奨。小さなテキストにLightウェイトは使用しない。
- タイプフェースは1つ、 デフォルトはサンセリフ。約5サイズを使用する。
- テキストやシャドウに
#000000は使用しない。#1F1F1Fなどの暗めの灰色を使用する。 - 1つのプライマリカラーのみ、目立たせる必要があるものにだけ適用する。すべてが目立つと、何も目立たなくなる。
- コントラスト: ボディテキストは4.5:1、大きなテキストとUI部品は3:1 (WCAG)。
- 意味を伝えるのに色だけに頼らない。 エラー、成功メッセージ、リンクには、アイコン、テキスト、ウェイト、アンダーラインも併用する。
- すべてのタップまたはクリックターゲットは少なくとも44×44 px、表示上のグリフがそれより小さくても同じ。
- ボタンの高さは40~60 px、 グループ内のプライマリボタンは1つ。ボタンがペアになる場合、プライマリは右側に配置。ラベルは実際の動作を正確に示す。
- 入力項目には常に表示ラベルを付ける。 プレースホルダーだけではラベルにならない。シングルカラムフォームを使用し、インライン検証を行い、ユーザーが入力した内容は決して消去しない。
- シャドウはソフトに(Yオフセット大、ブラー大、不透明度5~10%)、インタラクティブまたは浮上した要素にのみ使用。
- アイコンは1つのパックから、 1つのスタイルで、同じストローク幅と丸みで統一。汎用的に知られていないアイコンにはラベルを付ける。
- アニメーションはフィードバックを与え、 持続時間は1000 ms未満とし、イージングを適用する(リニアは不可)。
- Lorem Ipsumは使わない。 実際の短く、人間らしいコピーを書く。エラーは問題の修正方法を伝える。ダイアログは対象オブジェクトと結果を明示する。
- 同じものは、同じ見た目、同じ振る舞いで、画面間で統一する。振る舞いはプラットフォームのパターンに従う。
どの参照ファイルを読むか
| タスクの対象 | 読むファイル |
|---|---|
| 新しいプロジェクトやテーマ、値の選定 | tokens.md(スペーシング、タイプスケール、色の役割、角丸、シャドウ、モーション、CSSスターター) |
| ページや画面のレイアウト、グリッド、スペーシング、階層 | layout.md |
| テキストスタイル、見出し、段落 | typography.md |
| パレット、ダークモード、シャドウ、グラデーション | color-and-depth.md |
| ボタンとCTA | buttons.md |
| フォーム、入力、セレクト、チェックボックス、バリデーション | forms.md |
| カード、アイテムのリスト | cards.md |
| アイコン | icons.md |
| タブバー、トップナビ、サイドバー、リンク | navigation.md |
| 写真、イラスト、空状態、404用アート | imagery.md |
| ブランドの雰囲気、ボタンラベル、ダイアログ、エラー、トーン | personality-and-copy.md |
| トランジション、ホバー、ローディング、フィードバック | motion.md |
| コントラスト、altテキスト、ターゲット、キャプション | accessibility.md |
| 再利用するコンポーネント、状態、空/404画面、デザインシステム | system-and-states.md |
| 完成した画面のレビュー | checklist.md |
すべてのパスは、このスキルの references/ フォルダ以下にあります。