マスター・ディテール・レイアウトシステム は何をしますか?
目的
マスター・ディテール・レイアウトシステム(スプリットペインまたはリスト詳細UIとも呼ばれる)は、プライマリなアイテムリスト(マスターペイン)をブラウズしながら、選択されたレコードの包括的な属性、コンテキストアクション、ネストされた履歴を隣接する同期されたワークスペース(詳細ペイン)に表示するための標準化された視覚レイアウトとインタラクションフレームワークを提供します。
マスター・ディテールパターンは、メールクライアント、カスタマーサポートヘルプデスク、CRM案件ビューアー、コードレビュープラットフォーム、監査ログ、クラウドリソースコンソールなど、高効率なWebプロダクティビティアプリケーションの基盤です。
効果的なマスター・ディテールインターフェースを設計するには、正確な空間比率、独立した垂直方向のコンテナ(グローバルなページスクロールを防止)、明確な視覚的選択状態、シームレスなマルチペイン同期、そしてサイドバイサイドのスプリットビューからシングルペインのバックスタックナビゲーションへの流動的なモバイルビューポート遷移を確立する必要があります。これらはすべて、フォーカス管理とキーボードナビゲーションに関するWCAG 2.1 AAアクセシビリティガイドラインに厳密に準拠します。
ユースケース
- ヘルプデスク&カスタマーサポートポータル: マスターペインでオープンチケットのリストをブラウズしながら、詳細ペインでスレッド会話、顧客履歴、内部メモを読む。
- エンタープライズCRM&セールスパイプライン: マスターペインで連絡先やアカウントをスキャンしながら、詳細ペインで案件ステージ履歴、今後のアクティビティ、連絡先詳細を確認する。
- Webメール&メッセージングアプリケーション: 左側のマスターカラムで受信トレイを確認しながら、右側の詳細ペインでアクティブなメッセージを読む、返信する、またはアーカイブする。
- DevOps&クラウドインスペクターダッシュボード: マスターペインでサーバーインスタンス、ログストリーム、デプロイメントパイプラインをフィルタリングしながら、詳細ペインでリアルタイムメトリクス、エラートレース、YAML設定を確認する。
- HR&応募者追跡システム(ATS): 候補者の応募を見ながら、履歴書、面接官評価、スケジュールツールを並べて確認する。
使用すべきでない場合
- 複数行の比較を必要とする表形式データワークスペース: ユーザーが複数の構造化属性にわたって多数のレコードを同時に比較する必要がある場合は、
data-table-ui-systemを使用します。 - ワークフローパイプラインボード: カードが個別のパイプラインステージ間で水平に移動されるステータスカラムワークフローの場合は、
kanban-board-ui-systemを使用します。 - 階層的なドキュメントツリー: 深くネストされたツリー構造のドキュメントナビゲーション(ファイルシステムディレクトリツリーなど)の場合は、
tree-view-navigation-systemを使用します。 - 直線的なステップバイステップウィザード: 各ビューが前のビューに基づいて構築される順次マルチステップフォームの場合は、
step-progress-systemまたはmulti-step-form-implementationを使用します。 - シンプルなスタンドアロンランディングページ: マーケティングランディングページや、コンテンツが単一のカラムで垂直に流れるシンプルな記事フィードの場合は、
article-layout-systemまたはsection-composition-systemを使用します。
入力
- 情報設計とアイテムスキーマ: マスターアイテムカードに表示する属性(ステータスバッジ、タイトル/件名、プライマリメタデータ、タイムスタンプなど)と詳細ワークスペースに表示する属性(完全なレコード本文、アクティビティ履歴、関連レコード、コンテキストアクションバーなど)。
- ビューポートシェルコンテキスト: 外部アプリケーションシェル(
dashboard-layout-systemまたはsidebar-navigation-system)によって提供されるレイアウト境界。 - ペイン幅の比率設定: カラムサイズ要件(例:マスター幅固定
360px+ 詳細flex: 1、またはパーセンテージ分割35% / 65%)。 - デザイントークン: サーフェスの高さ、ニュートラルな境界線、フォーカスリングインジケーター、タイポグラフィスケール(
accessible-color-system、elevation-and-depth-system、fluid-spacing-system)。
出力
- スプリットペインレイアウト仕様: 固定 vs 流動的なペイン比率、独立した垂直スクロールコンテナ(
overflow-y: auto)、視覚的な区切り線のための CSS Grid / Flexbox 空間定義。 - マスターアイテム選択とアクティブ状態の設計図: 未読、ホバー、フォーカス、選択(
aria-selected="true")、リスト内の複数選択チェックボックス状態の視覚仕様。 - 詳細ワークスペース階層とヘッダー構造: 詳細ビューアクションバー(スティッキーヘッダー、戻るボタン、ステータスコントロール、プライマリ/セカンダリアクション)とコンテンツタブ/セクションの空間レイアウト。
- レスポンシブビューポート適応モデル: デスクトップ/ノートPCでのデュアルペインスプリットビューから、タブレット/モバイル画面でのシングルペインバックスタックナビゲーション(アニメーションパネルスライド付き)に切り替えるためのステップバイステップのレイアウト遷移ルール。
- アクセシブルなキーボードとARIAインタラクションモデル: フォーカストラップ、ロービング
tabindexまたは APG リストボックスフォーカスルーティング、ARIA ランドマーク(role="region"、aria-controls)、aria-live="polite"によるスクリーンリーダーへのステータス通知。
ワークフロー
1. デュアルペインキャンバスコンテナを確立する
アプリケーションシェル内に外側のマスター・ディテールラッパーを構築します(dashboard-layout-system):
- コンテナビューポートロック: 外側のラッパーを
display: flex; height: 100vh; max-height: 100vh; overflow: hidden;に設定するか(親ダッシュボードコンテンツ領域内に収まるようにします)、レイアウト全体の高さを固定し、ブラウザレベルでのウィンドウスクロールを排除します。 - 分割比率カラムグリッド: CSS Grid または Flexbox を使用してスプリットペインの比率を定義します:
- 固定マスターパターン(受信トレイ/CRMに推奨):
grid-template-columns: minmax(300px, 380px) 1fr;(マスターペインは 300px から 380px の快適なスキャン幅を維持し、詳細ペインは残りのすべての水平スペースを消費します)。 - 比例分割パターン: 高密度検査ツールの場合は
grid-template-columns: 35% 65%;または40% 60%。
- 固定マスターパターン(受信トレイ/CRMに推奨):
- 視覚的なペインセパレーター: ペイン間に 1px のソリッドボーダー(
border-right: 1px solid var(--border-subtle))またはアクセシブルなリサイズ可能なスプリットバー(accessible-split-pane-implementation)を挿入します。
2. マスターリストペイン構造を設計する
マスターペインは、レコードコレクションの高速スキャンインデックスとして機能します:
- スティッキーヘッダー領域: マスターペインの上部に固定の検索およびフィルターコントロールバーを配置します(
flex-shrink: 0; padding: 12px 16px; border-bottom: 1px solid var(--border-subtle); background: var(--surface-card))。クイック検索フィールド(search-interface-system)、フィルターチップ、一括アクショントリガーを含めます。 - 独立したスクロール可能なアイテムリスト: リストアイテムを
flex: 1; overflow-y: auto; overflow-x: hidden; -webkit-overflow-scrolling: touch;(role="list"またはrole="listbox")のコンテナでラップします。 - マスターアイテムカードの構造:
- トップ行: プライマリ識別子/作成者(
font-weight: 600; font-size: 0.875rem; color: var(--text-primary))、ステータスピル/バッジ、タイムスタンプ(font-size: 0.75rem; color: var(--text-muted))。 - ミドル行: アイテムの件名またはタイトル(
font-weight: 500; font-size: 0.875rem; color: var(--text-primary); text-truncate: 1 line)。 - ボトム行: スニペットまたはプレビューテキスト(
font-size: 0.8125rem; color: var(--text-secondary); line-clamp: 2)、タグ/カテゴリ、担当者アバター(user-avatar-system)。
- トップ行: プライマリ識別子/作成者(
- 状態スタイリングルール:
- 未読/未処理状態: 太字のタイトルテキストと微妙な視覚的手がかり(例:左側に 8x8px のプライマリアクセントドット)。
- ホバー状態: 背景のハイライト(
background: var(--surface-hover); cursor: pointer)。 - アクティブ/選択状態: 明確なアクティブサーフェス背景(
background: var(--surface-active-subtle))、左ボーダーに 3px のソリッドプライマリアクセントインジケーターストリップ(border-left: 3px solid var(--brand-primary))、およびaria-selected="true"。 - フォーカス可視状態: 非常に視認性の高いフォーカスアウトライン(
outline: 2px solid var(--focus-ring); outline-offset: -2px)。
3. 詳細ワークスペースペイン構造を構築する
詳細ペインは、アクティブなレコードの完全なコンテキストとワークスペースをレンダリングします:
- 空の状態表示: マスターペインでレコードが選択されていない場合、詳細ペインにアクセシブルな空の状態(
empty-state-system)を表示します。微妙なアイコン、明確な見出し(「レコードが選択されていません」)、役立つヒント(「詳細を表示するにはリストからアイテムを選択してください」)を含めます。 - スティッキー詳細アクションバー: 詳細ペイン内に永続的なトップヘッダーバーをレンダリングします(
position: sticky; top: 0; z-index: 10; display: flex; align-items: center; justify-content: space-between; padding: 12px 24px; border-bottom: 1px solid var(--border-subtle); background: var(--surface-card)):- モバイル戻るトリガー: デスクトップでは非表示の「リストに戻る」ボタンを含めます(
<button class="mobile-back-btn">← 戻る</button>)。 - レコード識別: レコード ID / タイトルサマリー(
font-weight: 600; font-size: 1rem)。 - アクションコントロール:
button-and-action-systemを使用してスタイル設定されたプライマリアクションボタン(例:「返信」、「編集」、「割り当て」、「削除」)。
- モバイル戻るトリガー: デスクトップでは非表示の「リストに戻る」ボタンを含めます(
- 独立したコンテンツスクロール領域: メインの詳細コンテンツ本文をスクロールコンテナでラップします(
flex: 1; overflow-y: auto; padding: 24px)。 - 詳細コンテンツレイアウト:
- ヘッダーセクション: H1 レコードタイトル、ステータスバッジ、メタデータグリッド(作成日、作成者、優先度、担当者)。
- プライマリ本文領域: 完全な説明、HTML スレッドメッセージ、または設定コードブロック。
- タブ付きサブセクション: 「アクティビティ履歴」「添付ファイル」「監査ログ」「関連レコード」を分離するためにタブ(
tab-ui-system)を使用します。
4. モバイルおよびタブレットのレスポンシブバックスタックナビゲーションを実装する
幅が 768px 未満(高密度アプリの場合は 1024px)の画面では、サイドバイサイドのペインを表示すると、テキストが読みにくくなり、ボタンが窮屈になります。レイアウトをシングルペインのバックスタックモデルに変換します:
- モバイルシングルペインビュー: 一度に 1 つのペインのみをフルビューポート幅(
width: 100%)でレンダリングします。 - ナビゲーションステートマシン:
- 状態 A(マスターアクティブ): マスターリストペインが 100% の幅を占めます。詳細ペインは視覚的に非表示になります(
display: noneまたはtransform: translateX(100%)で画面外に移動)。 - 状態 B(詳細アクティブ): ユーザーがマスターアイテムをタップすると、ビューポートが切り替わります。詳細ペインが 100% の幅を取り、マスターペインは非表示になります。
- 状態 A(マスターアクティブ): マスターリストペインが 100% の幅を占めます。詳細ペインは視覚的に非表示になります(
- モバイル戻るボタン: 状態 B では、詳細ペインに目立つ左上の「リストに戻る」ボタンが表示されます。タップするとステートマシンが状態 A にリセットされ、キーボードフォーカスが以前に選択されたマスターリストアイテムに戻ります。
- ビューポートアニメーション: スムーズなスライディングビュー遷移(
view-transitions-implementationまたは水平 CSS 変換transform 0.25s ease-in-out)を使用して、方向性のある道案内(詳細にスライドイン、マスターリストにスライドバック)を強化します。
5. アクセシブルなフォーカスとスクリーンリーダーのインタラクションを確保する
- ARIA ランドマークとリージョンロール: マスターペインコンテナに
role="region" aria-label="アイテムリスト"、詳細ペインコンテナにrole="region" aria-label="アイテム詳細ワークスペース"を割り当てます。 - リストボックス / 選択マークアップ: マスターリストが単一選択ウィジェットとして動作する場合は、リストに
role="listbox" aria-label="..."を、リストアイテムにrole="option" aria-selected="true|false"を適用します。または、aria-current="page"またはaria-current="true"を持つ標準の<nav>を使用します。 - レコード選択時のフォーカス管理: ユーザーがキーボードまたはポインターを使用してマスターアイテムを選択する場合:
- ユーザーが矢印キー(上/下)で高速スキャンしている場合は、キーボードフォーカスをマスターリスト内に維持します。
- 詳細ペインの DOM を非同期に更新し、
aria-live="polite"ステータス領域を介してレコードの読み込みを通知します:「チケット #1042 を読み込みました:支払い処理エラー」。 - ユーザーが選択したリストアイテムから
EnterまたはTabを押すと、シームレスにフォーカスを詳細ペインのプライマリアクションまたはヘッダー H1 に移動します(tabindex="-1")。
- モバイルビューポートのフォーカストラップと復元: モバイルで詳細ビューに切り替えると、フォーカスを自動的にモバイル戻るボタンまたは詳細ヘッダーに移動します。マスタービューに戻ると、以前にアクティブだったマスターアイテムにフォーカスを復元します。
決定ルール
ペインレイアウトと分割戦略
| ビューポート幅 | 推奨レイアウトパターン | マスターペイン幅 | 詳細ペイン幅 |
|---|---|---|---|
| ワイドデスクトップ (>1280px) | デュアルペインスプリットビュー(またはサイドバー付き3ペイン) | 固定 360px - 400px | 流動的 flex: 1(min-width: 600px) |
| 標準デスクトップ (1024px - 1279px) | デュアルペインスプリットビュー | 固定 320px - 350px | 流動的 flex: 1(min-width: 480px) |
| タブレット (768px - 1023px) | 狭いデュアルペイン または シングルペインスタック | 固定 280px - 300px(または折りたたみ可能) | 流動的 flex: 1 |
| モバイル (<768px) | シングルペインバックスタックビュー | 100%(状態 A) | 100%(状態 B) |
マスターリストの選択 vs フォーカスモデル
- フォーカス時に自動選択(高速スキャニング):
上または下矢印キーを押すと、アクティブな選択が即座に変更され、詳細ペインがリアルタイムで更新されます。メールの読み取り、ログ監査、大量のチケットスクリーニングに推奨します。 - アクション時に明示的に選択(Enter を押す/クリック): 矢印キーでマスターアイテムをナビゲートすると、詳細ペインを更新せずに視覚的なフォーカスリングが移動します。詳細ペインは、ユーザーが明示的に
Enter、Space、またはクリックした場合にのみ更新されます。詳細レコードの読み込みに大量のネットワーク API リクエストやフォーム状態の編集が伴う場合に推奨します。
制約
- アクセシビリティ(WCAG 2.1 AA):
- SC 2.1.1 キーボード: ユーザーは、キーボードコントロールのみを使用して、マスターアイテムのスクロール、レコードの選択、詳細ワークスペースへの移動、アクションのトリガー、マスターリストへの復帰ができなければなりません。
- SC 2.4.7 フォーカス可視: アクティブおよびフォーカスされたマスターアイテムは、背景に対して最低 3:1 のコントラスト比を満たすクリップされていないフォーカスリングを備えている必要があります。
- SC 4.1.2 名前、ロール、値: マスターアイテムは、
aria-selected="true"またはaria-current="true"を介して、支援技術にアクティブ/選択状態を明示的に伝える必要があります。 - SC 2.5.8 ターゲットサイズ: マスターリストアイテムと詳細アクションボタンのタップターゲットは、最低 24x24px のターゲット領域を提供する必要があります(モバイルタッチディスプレイでは 44x44px が推奨)。
- レイアウトコンテインメントと CLS: 全体のコンテナの高さは常にロックする必要があります。マスターアイテムの動的な高さや詳細コンテンツが、親コンテナやブラウザビューポートの境界を超えてレイアウトシフト(累積レイアウトシフト、CLS)を引き起こしてはなりません。
- パフォーマンスと仮想化: 500 を超えるマスターアイテムがあるコレクションの場合は、
virtual-scrolling-systemを使用して、リストコンテナ内の DOM ノードの数を可視ビューポートのアイテムに制限します。 - URL 状態とディープリンク: 選択されたレコードの ID をクエリパラメータ(例:
?selectedRecordId=abc123)として URL に保持します。これにより、ブラウザの戻る/進むナビゲーション、ブックマーク、共有、マスター・ディテール状態への完全なページリロード復元が可能になります。