Communitygithub.com

マスター・ディテール・レイアウトシステム

コレクションをナビゲートしながら、レコードの詳細なコンテキスト、独立したスクロール領域、モバイルバックスタック遷移を維持する、体系的でアクセシブルかつレスポンシブなマスター・ディテール(スプリットペイン/リスト詳細)レイアウトフレームワークを設計・実装します。

マスター・ディテール・レイアウトシステム とは?

マスター・ディテール・レイアウトシステム(スプリットペインまたはリスト詳細UIとも呼ばれる)は、プライマリリスト(マスターペイン)でアイテムをブラウズしながら、選択されたレコードの属性、コンテキストアクション、履歴を隣接するワークスペース(詳細ペイン)に表示するための標準化された視覚レイアウトとインタラクションフレームワークを提供します。このパターンは、メールクライアント、カスタマーサポート、CRM、コードレビューツールなど、高効率なWebプロダクティビティアプリケーションの基盤です。CSS Grid/Flexboxによるペイン分割、独立したスクロールコンテナ、レスポンシブ対応(デュアルペインからモバイルのシングルペインバックスタックへの切り替え)、WAI-ARIAによるアクセシビリティ(フォーカス管理、キーボードナビゲーション、`aria-selected`)を実装します。このスキルは、Claude Code、Cursor、CodexなどのAIエージェント向けに設計されており、開発者が一貫性のあるアクセシブルなマスター・ディテールインターフェースを効率的に構築するのに役立ちます。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/master-detail-layout-system

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

マスター・ディテール・レイアウトシステム は何をしますか?

目的

マスター・ディテール・レイアウトシステム(スプリットペインまたはリスト詳細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 を使用します。

入力

  1. 情報設計とアイテムスキーマ: マスターアイテムカードに表示する属性(ステータスバッジ、タイトル/件名、プライマリメタデータ、タイムスタンプなど)と詳細ワークスペースに表示する属性(完全なレコード本文、アクティビティ履歴、関連レコード、コンテキストアクションバーなど)。
  2. ビューポートシェルコンテキスト: 外部アプリケーションシェル(dashboard-layout-system または sidebar-navigation-system)によって提供されるレイアウト境界。
  3. ペイン幅の比率設定: カラムサイズ要件(例:マスター幅固定 360px + 詳細 flex: 1、またはパーセンテージ分割 35% / 65%)。
  4. デザイントークン: サーフェスの高さ、ニュートラルな境界線、フォーカスリングインジケーター、タイポグラフィスケール(accessible-color-system、elevation-and-depth-system、fluid-spacing-system)。

出力

  1. スプリットペインレイアウト仕様: 固定 vs 流動的なペイン比率、独立した垂直スクロールコンテナ(overflow-y: auto)、視覚的な区切り線のための CSS Grid / Flexbox 空間定義。
  2. マスターアイテム選択とアクティブ状態の設計図: 未読、ホバー、フォーカス、選択(aria-selected="true")、リスト内の複数選択チェックボックス状態の視覚仕様。
  3. 詳細ワークスペース階層とヘッダー構造: 詳細ビューアクションバー(スティッキーヘッダー、戻るボタン、ステータスコントロール、プライマリ/セカンダリアクション)とコンテンツタブ/セクションの空間レイアウト。
  4. レスポンシブビューポート適応モデル: デスクトップ/ノートPCでのデュアルペインスプリットビューから、タブレット/モバイル画面でのシングルペインバックスタックナビゲーション(アニメーションパネルスライド付き)に切り替えるためのステップバイステップのレイアウト遷移ルール。
  5. アクセシブルなキーボードと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%。
  • 視覚的なペインセパレーター: ペイン間に 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")のコンテナでラップします。
  • マスターアイテムカードの構造:
    1. トップ行: プライマリ識別子/作成者(font-weight: 600; font-size: 0.875rem; color: var(--text-primary))、ステータスピル/バッジ、タイムスタンプ(font-size: 0.75rem; color: var(--text-muted))。
    2. ミドル行: アイテムの件名またはタイトル(font-weight: 500; font-size: 0.875rem; color: var(--text-primary); text-truncate: 1 line)。
    3. ボトム行: スニペットまたはプレビューテキスト(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% の幅を取り、マスターペインは非表示になります。
  • モバイル戻るボタン: 状態 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 に保持します。これにより、ブラウザの戻る/進むナビゲーション、ブックマーク、共有、マスター・ディテール状態への完全なページリロード復元が可能になります。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for non-overlay notifications, managing global announcements and contextual inline alerts to communicate system states without interrupting the user's flow.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for secondary navigation trails that provide orientation, context, and one-click access to parent levels in deep information architectures.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for threaded conversations, managing nesting depths, action hierarchies, and community signaling to foster engagement and readability.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and implement a systematic color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

関連スキル