UXデザイン は何をしますか?
パーソナルスキル。3冊の本(Lowdermilk『ユーザー中心設計』、Yablonski『UXの法則』、Wathan & Schoger『Refactoring UI』)とNN/g、WCAG 2.2、公開デザインシステムを独自の言葉で要約。詳細、出典、未検証のものは references/ にあり。このファイルは常に頭に入れておくべき内容。
0. 優先順位
2つのアドバイスが衝突した場合、上位のものが優先される:
- プロジェクトのデザインシステムと指示(CLAUDE.md、トークン、プリミティブ、ブランドガイド)。プロジェクトが「角丸0、影なし」と言っているなら、Refactoring UIが影を推奨しても提案しない。奥行きはシステムが許可する方法(罫線、背景、スペース)で実現する。新しいものを発明する前に、既存のトークンとコンポーネントを読むこと。
- ハードルール:WCAG 2.2 AAアクセシビリティとユーザーを欺かないこと。プロジェクトのシステムがコントラストやフォーカスに違反している場合は、WCAGの基準とシステム内の代替案を指摘する。
- エビデンス:データに基づく研究とガイドライン(NN/g、Baymard、GOV.UK、ISO規格)。
- 職人技:Refactoring UIや類似の戦術的アドバイス。デフォルトでは良いが、絶対的な法則ではない。
推奨事項がどのレベルに属するかを常に明記すること:「WCAG 1.4.3(必須)」と「通常はこの方が見栄えが良い」は重みが異なる。
1. 描画前のニーズ確認
リクエストは解決策として届くことが多い(「CSVエクスポートを追加」「ここにボタンを配置」)。その背後にはニーズがあり、文字通りの解決策を設計すると、より多くの画面領域を消費し、より悪い結果を生む傾向がある。そのため、設計前に:
- リクエストを再構成する:[状況]のとき、[人物]が[結果]を[理由]で望む。状況や理由が埋められない場合は、質問するか仮定を宣言する。
- 使用状況(ISO 9241-11):誰が、どのタスクを、どこで、何を使って(太陽の下のモバイル、デュアルモニターのデスクトップ、日常的なエキスパートまたは年1回の利用)。「使いやすい」は抽象的な概念ではなく、常に誰か、タスク、コンテキストに対して定義される。
- 現在の回避策を探す(Excel、WhatsApp、紙):これが本当に必要なものの最良の仕様である。
- より少ないインターフェースで同じニーズを解決する代替案を少なくとも1つ提示する(存在する場合)。
- まずはハッピーパス、その直後に状態:ローディング、空(初回/フィルター/権限なし)、エラー、成功、部分。状態のない画面は設計されていない。
インタビュー、ユーザビリティテスト、ユーザー数、メトリクス、SUSについては → references/centrado-en-usuario.md。
2. 構造とインタラクション(ユーザビリティに最も影響するもの)
ニールセンのヒューリスティックス、一覧チェックリスト:
- システム状態の可視性:システムが何が起こっているかを伝える(保存中、保存済み、ロード中、エラー)。
- システムと現実世界との一致:データモデルではなくユーザーの言葉を使う。
- ユーザーの制御と自由度:元に戻す、キャンセル、戻る。
- 一貫性と標準:同じものは同じに見え、同じ動作をし、慣習を尊重する。
- エラーの防止:制約、適切なデフォルト値、さまざまな形式の受け入れ。
- 記憶よりも認識。
- 初心者を妨げずにエキスパート向けのショートカットを提供。
- ミニマリストデザイン:各要素は他の要素と競合する。
- エラーを明確に示し、修復方法を提案する。
- ヘルプとドキュメント。
最もよく使われるUXの法則とその限界:
| 法則 | 適用 | 注意点 |
|---|---|---|
| ヤコブ | 慣習的なパターン;ナビゲーションではなく価値において革新する | 業界の慣習(ERP、CAD)は一般的なウェブの慣習よりも優先される |
| フィッツ | 注目領域の近くに大きなターゲットを配置;最終フィールドの横に送信ボタン | 「無限大」のコーナーはマウスでのみ有効で、タッチでは無効 |
| ヒック | 急ぎの場合は選択肢を減らす;推奨オプションを強調;段階的に表示 | 既知のオプションから選択する場合にのみ有効;検索の場合は組織化(順序、グループ、検索)が優先 |
| ミラー/ワーキングメモリ | チャンキングでグループ化;システムがユーザーの代わりに記憶 | 「7±2」はメニューを制限しない:表示されているものはメモリに負荷をかけない。実際の容量は約4ブロック(Cowan) |
| テスラー | 複雑さはシステムが吸収する(デフォルト値、オートコンプリート、計算) | 隠すことは簡略化ではない:複雑さを移動させるだけ |
| ポステル | さまざまな形式を受け入れ、正規化する | 受け入れることは黙って推測することではない:曖昧な場合は解釈を表示するか質問する |
| ピークエンド | 最も価値のある瞬間と終了時に注意を払う;ネガティブなピークに注意 | — |
| フォン・レストルフ | ゾーンごとに1つの強調要素のみ | すべてを強調すると何も強調されず、広告のように見える可能性がある |
| 応答時間 | <0.1秒:処理不要;~1秒:軽いフィードバック;2~10秒:スケルトンまたはスピナー;>10秒:% + キャンセル | Dohertyの「400ms」は1982年の元のレポートには記載されていない;代わりにNielsenの0.1/1/10秒を使用 |
| ゴールグラディエント | 長いプロセスでは進行状況を表示し、正直に保つ | 虚偽の進行状況は欺瞞的なパターンである |
30の法則、状況別マップ(フォーム、オンボーディング、チェックアウト、テーブル、モバイルなど)、悪用例については → references/leyes-ux.md。
エビデンスに基づくパターン(詳細と出典は → references/patrones.md):
- フォーム:ラベルは上部に表示し、常に可視(プレースホルダーをラベルとして使用しない);1列;正しい
autocompleteとinputmode;電話番号、日付、IBANを複数のフィールドに分割しない;フィールド離脱時または送信時に検証し、修正されたらすぐにエラーを削除(「早く報い、遅く罰する」);エラーはフィールドの横に表示し、何が起こったかと修復方法をラベルの言葉で説明;常に入力内容を保持。 - ボタン:動詞+目的語(「OK」ではなく「請求書を保存」);ビューごとに1つのプライマリボタン;理由を説明しない無効化ボタンは避ける(クリックを許可し、説明する方が良い);二重送信を防止。
- 破壊的操作:確認よりも元に戻す;取り返しのつかない操作のみ確認し、失われるものを明示し、アクションを含むボタン(「3件の請求書を削除」/「保持」)を使用。Yes/Noは使用しない。
- 空状態:空であること(ローディングではない)、ここに何が表示されるか、開始ボタンを表示;何もない間はフィルターと並び替えを非表示にする。
- テーブル:最初の列に読み取り可能な識別子;数値は
tabular-numsで右揃え、小数点以下桁数を統一;固定ヘッダー;アクティブなフィルターが表示された状態でフィルターを可視に;行アクションはマウスホバー時だけでなく常に可視;ドラッグの代替手段。モバイル:レコード確認用カード、比較用に最初の列を固定したテーブル。 - ダッシュボード:1つのタスク;各数値に比較、単位、期間を含む;円グラフや速度計よりも棒グラフと折れ線グラフ;色には意味を持たせ、唯一の手がかりにしない。
- ナビゲーション:デスクトップでは可視(ハンバーガーメニューは発見性を低下させる);モバイルでは3~5つのアイコン+テキストの下部ナビゲーションバー;頻繁に使用するものは到達可能なゾーンに、重要なものは上部コーナーに配置しない。
- マイクロコピー:重要な要素は最初の2語に;単語数を半分に削減;スキャン可能なサブタイトル;能動態の短い文;「お願いします」「おっと」「無効」は使用しない。
3. ビジュアルデザイン(Refactoring UIの要点)
値とCSS/Tailwindの詳細は → references/diseno-visual.md(§11がチートシート)。
- レイアウトではなく機能から始める、そしてグレースケールで:グレーで階層が機能しない場合、色では修正できない。色は最後に追加する。
- 値よりもシステム:間隔、フォントサイズ、色、影、角丸の固定スケールを定義し、それらから選択して決定する。コードではトークンを使用;理由のない恣意的な値(
p-[13px])は使用しない。 - サイズではなく、ウェイトと色で階層を作る:2~3のテキストトーン(プライマリ、セカンダリ、ターシャリ)と2つのウェイト(標準とセミボールド/ボールド);400未満は使用しない。何かを強調することは、多くの場合、競合するものを薄くすることである。
- ラベルは最後の手段:それ自体で説明可能な形式(「在庫:12」よりも「12点在庫あり」);ラベルが必要な場合は値よりも軽くする。セクションタイトルは小さなラベルとして機能することが多い:視覚的な階層は
h1…h6の階層に従う必要はない。 - スペーシング:多すぎるくらいの余白から始めて削る;非線形スケール(4, 8, 12, 16, 24, 32, 48, 64, 96…)で、各ステップが次のステップの約25%未満にならないようにする;グループ間のスペースはグループ内よりも広くする(ラベルはフィールドに近接)。
- 幅:画面全体に引き伸ばさない;コンポーネントごとに
max-widthを設定;段落は45~75文字;サイドバーは固定幅、コンテンツはフレキシブル。 - テキスト:手動で作成したタイポグラフィスケール(12/14/16/18/20/24/30/36/48…)をpxまたはremで使用(emは不可);本文は約1.5、見出しは約1~1.25の行間;大きな見出しはトラッキングをやや詰め、大文字はトラッキングを広く;異なるサイズを混在させる場合はベースラインを揃える;テキストの中央揃えは2~3行のみ。
- 色:8~10のグレー(わずかに色味を帯びたもの)と、色ごとに5~10のトーン(100~900)を事前に定義。できればOKLCH(知覚的に均一な明るさ)で;両端でクロマを高く;色付き背景にグレーテキストは絶対に使用しない(同じ色のトーンを使用);バッジは反転コントラスト(薄い色付き背景と濃い同色テキスト);色は唯一の合図として使用しない。
- 重要度に基づくボタン、セマンティクスではない:プライマリは塗りつぶし、セカンダリはアウトラインまたは薄い塗りつぶし、ターシャリはリンク風。破壊的操作は、それが主要なアクションである場合(確認ダイアログの最終ボタン)にのみ大きく赤くする。
- 奥行き(システムがサポートする場合):上からの光;約5つの影(2層);境界線を減らす(スペース、背景、または影で分離);アクセントボーダーで色を追加。影なし:背景の違いと細い罫線。
- 画像:アイコンはスケーリングしない(背景付きの形状に配置);ユーザーがアップロードした画像は
object-fit: coverの固定コンテナに配置;画像上のテキストにはコントラストを保証するオーバーレイが必要。 - ダークモード:セマンティックトークンを再割り当てし、反転させない;浮上レベルに応じて明るくなる表面;彩度を抑えたアクセント。
- 数字:比較または更新されるものすべてに
font-variant-numeric: tabular-numsを使用。
4. アクセシビリティ:譲れない最低限
WCAG 2.2 AAが目標(EUではEN 301 549 V4.1.1が要求)。A/AAの55の基準、ARIA、モーダル、ライブリージョン、テスト手順を含む完全なチェックリストは → references/accesibilidad.md。
- ARIAよりもネイティブHTML(
button、a href、label、fieldset、dialog);クリック可能なdivはゼロ。 - コントラスト:テキスト ≥ 4.5:1;大きいテキスト(≥ 24px、または太字で≥ 18.66px)、入力ボーダー、情報を伝えるアイコン、フォーカスは ≥ 3:1。WCAG 2.xの計算式で測定(APCAではない)。
- 完全なキーボード操作;可視フォーカス(
:focus-visible)、ヘッダーや固定バーで隠れない(scroll-padding);モーダル内にフォーカスを閉じ込め、Escで閉じ、閉じた後はフォーカスを元の場所に戻す。 - ターゲットサイズ ≥ 24×24 px CSS(法的最低限);タッチでは44~48 pxで設計。
- ドラッグするものすべてにドラッグなしの代替手段がある(カンバン、並べ替え、スライダー)。
- エラーはフィールドの横にテキストで表示し、
aria-invalidとaria-describedbyを使用;色だけに依存しない。 - 非同期状態は
role="status"(緊急の場合はalert)で通知し、リージョンは事前にマウントしておく。 - ログイン:ペースト可能;
autocompleteをusername、current-password、one-time-codeで使用;認知テストは不要。 - 同じプロセス内で既に入力された情報を再要求しない。
- 320pxで水平スクロールなしでリフロー(データテーブルを除く);200%ズーム;
prefers-reduced-motion。 - axeが緑でもアクセシブルとは限らない:GOV.UKの調査では、最良のツールでもバリアの約41%しか検出できなかった(すべてのツールを組み合わせて約71%)。Dequeはaxeがインシデントの約57%を検出すると推定。キーボードでの操作とスクリーンリーダーでの簡単なテストも必要。
5. リクエストに応じた作業方法
コードでのUI実装または改善
- プロジェクトのデザインシステム(トークン、プリミティブ、既存の類似コンポーネント)を読み、作成する前に再利用する。
- ニーズ、コンテキスト、状態を記述する(§1)。
- まずグレースケールで機能と階層を構築;その後、トークンを使用してスペーシング、タイポグラフィ、色を追加。
- 状態をカバーする:default、hover、focus-visible、active、disabled(理由付き)、loading、空、エラー、成功。
- 確認:モバイル幅(320~380 px)とデスクトップ、キーボード、コントラスト、長いテキストまたは極端なデータ(60文字の名前、7桁の金額、0行と500行のリスト)。ブラウザが利用可能な場合は実際の画面を確認:スクリーンショットはコードでは見えないものを明らかにする。
画面、スクリーンショット、PRのレビュー
§2~§4を実行し、以下を返す:
- 要約:2~3行で、何が機能しているかと最もコストのかかる問題。
- 発見事項:重大度順(Nielsenスケール:4 壊滅的、公開前に修正 · 3 メジャー · 2 マイナー · 1 コスメティック)。各項目に:場所、違反している原則(ヒューリスティック、法則、またはWCAG基準番号)、影響を受けるユーザーとその影響、具体的な修正(値、コンポーネント、コピー)、必須と好みを区別。重大度は単一評価者によるものであることを宣言。
- クイックフィックス:最大5つ、最も影響が大きく労力が少ないもの。
- 未解決の質問:データまたはユーザーによってのみ解決できるもの。
代替案間の決定
主なタスクとコンテキスト(§1)に対して比較し、好みで判断しない。差異が実際の動作に依存する場合は、その旨を伝え、それを解決するための最も安価なテスト(5ユーザーテスト、A/Bテスト、分析)を提案する:references/centrado-en-usuario.md §5。
コードなしでの設計(フローまたはワイヤーフレーム)
再構成されたニーズ、ハッピーパスのフローとその状態、各画面の構造(決定ごとに原則を付けて)、ユーザー検証が必要な事項を納品する。
6. 行動ルール
- 一般的な表現よりも具体的に:「コントラストを改善」ではなく、「Tailwind v3のセカンダリテキストを
gray-400からgray-600に上げる(2.5:1 → 7.6:1、白地;WCAG 1.4.3は4.5:1を要求)」のように言う。 - 推奨事項ごとに理由を1行添え、出典を明記する。
- トークンを使用する:CSSの生の値ではなく、デザイントークン(
--color-text-secondary、spacing-4)を参照する。 - 解決策の範囲を理解する:このガイドはすべてのUIをカバーするものではなく、十分な情報に基づいた決定を下すための枠組みを提供する。答えるよりも質問することが重要。