構造を伝えるレイアウト
レイアウトは、一つも文字が読まれる前にコミュニケーションを始めます。位置、間隔、整列はそれだけで階層を伝え、十分な余白は装飾よりも効果的です。優れたレイアウトはストレスにも耐えます。リサイズ、翻訳、RTLへのミラーリングを行っても、構造が崩れません。これらの原則をUIコードの構築やレビュー時に適用し、すべての変更はプロジェクトの既存のスタイリングシステム(Tailwind、プレーンCSS、CSS-in-JS)で表現し、新しいスタイリング手法を導入しないでください。
ヒットエリアサイズとフォーカス動作は better-accessibility スキルが、視覚的な仕上げ(radius、シャドウ、アニメーション)は better-ui スキルが、行の長さとテキスト間隔は better-typography スキルが担当します。
以下の数値は、確立された密度や間隔のシステムがないインターフェースの出発点として扱ってください。意図的なプラットフォームのクローム、コンパクトなプロフェッショナルツール、プロジェクトのトークンは、ヒットエリア、ズーム、ローカリゼーション、ビューポートのストレステストで使用可能な状態を維持できる場合は保持してください。
クイックリファレンス
| カテゴリ | 使用タイミング |
|---|---|
| グルーピングと整列 | スペース vs セパレーター、整列エッジ、論理プロパティ、重要度順序 |
| 間隔と適応性 | ターゲット間の間隔、レイアウトマージン、プログレッシブディスクロージャー、フルブリードコンテンツ、ブレークポイント、i18nによる拡大 |
コア原則
1. 線ではなくスペースでグループ化する
負のスペースが主要なグルーピングツールであり、背景形状がそれに次ぎ、セパレーター線は最後で、スペースだけでは構造を伝えきれない場合にのみ使用します。グループ間のギャップは、グループ内のギャップの少なくとも2倍(グループ内 8px → グループ間 16px 以上)でなければならず、そうでなければグルーピングはノイズとして認識されます。
2. コントロールはコンテンツと明確に区別する
インタラクティブ要素はインタラクティブに見える必要があります。背景形状、ボーダー、または一貫した配置ゾーンを使用します。コントロールを隣接する静的テキストと同一にスタイリングしないでください。
3. 共有エッジに整列する
整列エッジを選択し、それに従ってください。はみ出したエッジはノイズとして認識されます。従属の各レベルにはプロジェクトの間隔ステップを1つ使用します(16px が便利なデフォルトです)。方向に依存するレイアウトには論理プロパティ(padding-inline-start、margin-inline-end)を使用し、物理的な left/right は本当に物理的な形状にのみ予約します。
4. 重要度順に並べる
最も重要なコンテンツは上部と先頭エッジ(leading edge)に配置します。読み取り順序は上から下、先頭から末尾へと流れます。left/right ではなく、leading/trailing で考えてください。
5. 隠れたコンテンツをほのめかす
プログレッシブディスクロージャーには、可視のアフォーダンスが必要です。プロジェクトで確立された合図を使用してください。それがなければ、次のアイテムをスクロールエッジから 16–32px はみ出させるか、ディスクロージャーコントロールを表示させます。合図なしに隠されたコンテンツは存在しないのと同じです。
6. ターゲット間に余裕を
確立された密度システムがない場合は、隣接するボーダー付きまたは塗りつぶしのコントロール間は 12px から、ボーダーレスのテキスト専用およびアイコン専用コントロールの周囲は 24px のクリアランスから始めてください。better-accessibility のヒットエリアが重ならず、コントロールが視覚的に区別可能な場合は、コンパクトなレイアウトではより少ない間隔を使用しても構いません。
7. ボタンを端から内側に配置する
コンテンツレイアウトでは、フルワイドボタンをレイアウトマージンの内側(モバイルではインライン 16px 程度から開始)に、可視の角丸を付けて配置します。エッジツーエッジのアクションは、それが意図的に確立されたプラットフォームまたはアプリケーションのクロームに従い、セーフエリアを考慮し、システムUIと区別可能である場合に限り許容されます。
8. コンテンツはあふれ、コントロールは浮かぶ
背景やメディアはビューポートの端まで広がります。コントロールとテキストはレイアウトマージンとセーフエリア(env(safe-area-inset-*))の内側に留まります。スティッキークロームはコンテンツレイヤーの上に浮かび、それをせき止めません。
9. 壊れるまで構造を維持する
ブレークポイントはデバイスのプリセットではなく、コンテンツから決まります。拡張レイアウトは実際に収まる限り維持し、折りたたみは遅らせます。コンポーネントレベルの適応にはコンテナクエリを優先します。最初に最小サイズと最大サイズをテストしてください。
10. 成長とクリッピングに備える
普遍的なパーセンテージに頼るのではなく、文字列の実質的な成長と言語依存の成長に備えてください。テキストコンテナに固定幅や固定高さを設定せず、行を折り返させます。リサイズやスクロールによって重要なアクションがクリップされる場所に配置しないでください。通常のフローまたはプロダクトに適した安定したクローム内で到達可能に保ちます。
よくある間違い
| 間違い | 修正 |
|---|---|
| スペースで十分な場所にセパレーター線 | 線を削除し、グループ間のギャップを2倍にする |
ローカライズ可能なレイアウトでの margin-left / padding-right | margin-inline-start / padding-inline-end |
| コンテンツレイアウトのボタンが誤ってビューポートに接触 | プロジェクトのマージン内に内側に配置。意図的なプラットフォームクロームは保持 |
| キャラクセル/スクローラーが完全に見えてしまう | 次のアイテムをエッジから 16–32px はみ出させる |
| 隣接するコントロールが融合、または拡大されたヒットエリアが重なる | プロジェクトのスケールを使用してギャップを拡大。12px/24px を出発点として使用 |
| デフォルトだからという理由で768/1024にブレークポイントを設定 | コンテンツが実際に収まらなくなる場所でブレーク |
| 1言語に合わせてサイズ設定された固定幅テキストコンテナ | max-width + 折り返し。擬似ローカリゼーションと代表的なロケールでテスト |
| ペインのクリップされやすい下部にある主要アクション | スティッキー配置、またはセーフエリアパディング付きの安定したクローム |
レビュー出力フォーマット
このフォーマットは、ユーザーがスタンドアロンのレイアウトレビューを要求した場合にのみ使用してください。better-interface がレビューを統括する場合は、そのスキルにドメインの証拠と所見を提供し、そのスキルの出力フォーマット、重大度スケール、統合ルール、上限、判定を優先させてください。
スタンドアロンレビューは2部構成で提示します。
所見
確認されたすべての所見を原則ごとにグループ化します。Severity、Location、Before、After、Why の列を持つマークダウンテーブルを使用します。「Before:」/「After:」の別行は使用しないでください。
- Severity:
HIGHはサポートされているビューポートでコンテンツまたはアクションをブロックするもの。MEDIUMは階層、読み取り順序、適応性を損なうもの。LOWは孤立した整列や間隔の洗練に関するもの。 - Location:
path/to/file:lineを引用。アーティファクトにソースファイルがない場合は、代わりに正確な画面とコンポーネントを引用。 - Before / After: 現在のレイアウトと実行可能な修正案を示す。
- Why: 違反した原則と、理解性や適応性への影響を記載。
繰り返し発生するシステム的な問題は1行に統合し、影響を受けるすべての場所をリストアップします。所見のない原則は省略します。
例
線ではなくスペースでグループ化
| Severity | Location | Before | After | Why |
|---|---|---|---|---|
| LOW | src/Settings.tsx:41 | すべての設定行に border-b | ボーダーを削除。グループ内は space-y-2、グループ間は space-y-8 を使用 | スペースはノイズの少ないグルーピングを伝達 |
| LOW | src/ProfileForm.tsx:58 | フォームセクション間の <hr> | 各セクション見出しに mt-10 に置き換え | セクション階層は繰り返しのルールに依存すべきではない |
共有エッジに整列
| Severity | Location | Before | After | Why |
|---|---|---|---|---|
| LOW | src/Card.tsx:24 | カードテキスト pl-4、カードアイコン pl-3 | 両方を同じ pl-4 エッジに整列 | 共有エッジは読みやすい構造を作る |
| MEDIUM | src/Nav.css:19 | margin-left: 16px | margin-inline-start: 16px | 物理プロパティは方向認識レイアウトを壊す |
検証と判定
所見の後:
- 検証: 実行した正確なチェックと、関連するビューポート幅、読み取り順序、ズーム、RTL状態における観察結果をリストアップします。チェックが実行されなかった場合は、まだ検証が必要な事項を明記します。
- 判定:
HIGHの所見が残っている場合はBlock、MEDIUMまたはLOWの所見のみの場合はNeeds changes、改善すべき所見がまったくない場合のみApproveとします。
所見がない場合は、テーブルを省略し、「No actionable layout findings」と記載し、検証結果を報告し、Approve で終了します。