Communitygithub.com

Master-Detail Layout System

Entwerfen und implementieren Sie ein systematisches, hochgradig zugängliches und responsives Master-Detail-Layout (Split-Pane / List-Detail) zur Navigation durch Sammlungen, wobei der tiefe Datensatzkontext, unabhängige Scrollbereiche und mobile Zurück-Stapel-Übergänge erhalten bleiben.

Was ist Master-Detail Layout System?

Das Master-Detail-Layout-System (auch bekannt als Split-Pane oder List-Detail UI) bietet ein standardisiertes visuelles Layout- und Interaktionsframework zum Durchsuchen einer primären Liste von Elementen (der „Master“-Pane) bei gleichzeitiger Anzeige umfassender Attribute, kontextueller Aktionen und tief verschachtelter Verläufe für den aktuell ausgewählten Datensatz in einem benachbarten, synchronisierten Arbeitsbereich (der „Detail“-Pane). Es ist grundlegend für hocheffiziente Web-Produktivitätsanwendungen wie E-Mail-Clients, CRM-Deal-Viewer, DevOps-Dashboards und Helpdesk-Portale. Das System legt präzise räumliche Proportionen, unabhängige vertikale Containment-Container (um globales Seiten-Scrollen zu verhindern), klare visuelle Auswahlzustände, nahtlose Mehrfachpane-Synchronisation und flüssige mobile Viewport-Übergänge fest – alles unter strenger Einhaltung der WCAG 2.1 AA-Richtlinien für Fokusmanagement und Tastaturnavigation. Es definiert Workflows für die Einrichtung des Dual-Pane-Canvas, die Gestaltung der Master-Liste mit fixen Headern und scrollbaren Elementen, den Aufbau des Detail-Arbeitsbereichs mit klebrigen Aktionsleisten sowie die Implementierung eines mobilen Back-Stack-Modells mit animierten Folienübergängen.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Master-Detail-Layout-System

Zweck

Das Master-Detail-Layout-System (auch bekannt als Split-Pane oder List-Detail UI) bietet ein standardisiertes visuelles Layout- und Interaktionsframework zum Durchsuchen einer primären Liste von Elementen (der "Master"-Pane) bei gleichzeitiger Anzeige umfassender Attribute, kontextueller Aktionen und tief verschachtelter Verläufe für den aktuell ausgewählten Datensatz in einem benachbarten, synchronisierten Arbeitsbereich (der "Detail"-Pane).

Master-Detail-Muster sind grundlegend für hocheffiziente Web-Produktivitätsanwendungen wie E-Mail-Clients, Kundensupport-Helpdesks, CRM-Deal-Viewer, Code-Review-Plattformen, Prüfprotokolle und Cloud-Ressourcen-Konsolen.

Die Gestaltung einer effektiven Master-Detail-Oberfläche erfordert die Festlegung präziser räumlicher Proportionen, unabhängige vertikale Container (um globales Seiten-Scrollen zu verhindern), klare visuelle Auswahlzustände, nahtlose Mehrfachpane-Synchronisation und flüssige mobile Viewport-Übergänge von einer nebeneinander angeordneten Split-Ansicht zu einer Single-Pane-Back-Stack-Navigation – alles unter strenger Einhaltung der WCAG 2.1 AA-Richtlinien für Fokusmanagement und Tastaturnavigation.

Anwendungsfälle

  • Helpdesk- & Kundensupport-Portale: Durchsuchen einer Liste offener Tickets im Master-Pane, während vollständige Thread-Konversationen, Kundenverlauf und interne Notizen im Detail-Pane gelesen werden.
  • Enterprise CRM & Vertriebspipelines: Scannen von Kontakten oder Konten im Master-Pane, während Deal-Stufenverlauf, anstehende Aktivitäten und Kontaktdetails im Detail-Pane eingesehen werden.
  • Webmail & Messaging-Anwendungen: Überprüfen eines Posteingangs in der linken Masterspalte, während die aktive Nachricht in der rechten Detailspalte gelesen, beantwortet oder archiviert wird.
  • DevOps & Cloud Inspector Dashboards: Filtern von Serverinstanzen, Log-Streams oder Bereitstellungspipelines im Master-Pane, während Echtzeitmetriken, Fehlerabläufe und YAML-Konfigurationen im Detail-Pane untersucht werden.
  • HR- & Bewerbermanagementsysteme (ATS): Navigieren durch Bewerbungen bei gleichzeitiger Ansicht von Lebensläufen, Bewerterbewertungen und Planungstools nebeneinander.

Wann NICHT zu verwenden

  • Tabellarische Datenarbeitsbereiche mit Multi-Row-Vergleichen: Wenn Benutzer dutzende Datensätze gleichzeitig über mehrere strukturierte Attribute vergleichen müssen, verwenden Sie data-table-ui-system.
  • Workflow-Pipeline-Boards: Für Status-Spalten-Workflows, bei denen Karten horizontal über diskrete Pipeline-Stufen bewegt werden, verwenden Sie kanban-board-ui-system.
  • Hierarchische Dokumentenbäume: Für tief verschachtelte baumstrukturierte Dokumentennavigation (z. B. Dateisystem-Verzeichnisbäume) verwenden Sie tree-view-navigation-system.
  • Lineare Schritt-für-Schritt-Assistenten: Für sequenzielle mehrstufige Formulare, bei denen jede Ansicht auf der vorherigen aufbaut, verwenden Sie step-progress-system oder multi-step-form-implementation.
  • Einfache eigenständige Landing Pages: Für Marketing-Landingpages oder einfache lineare Artikel-Feeds, bei denen Inhalte vertikal in einer einzigen Spalte fließen, verwenden Sie article-layout-system oder section-composition-system.

Eingaben

  1. Informationsarchitektur & Elementschema: Attribute, die in der Master-Item-Karte dargestellt werden (z. B. Status-Badge, Titel/Betreff, primäre Metadaten, Zeitstempel) gegenüber dem Detail-Arbeitsbereich (vollständiger Datensatztext, Aktivitätsverlauf, zugehörige Datensätze, kontextuelle Aktionsleisten).
  2. Viewport-Shell-Kontext: Layoutgrenzen, die von der äußeren Anwendungsshell bereitgestellt werden (dashboard-layout-system oder sidebar-navigation-system).
  3. Präferenzen für Pane-Breiten-Proportionen: Spaltengrößenanforderungen (z. B. Feste Master-Breite 360px + flüssiges Detail flex: 1, oder prozentuale Aufteilung 35% / 65%).
  4. Design-Tokens: Oberflächenhöhen, neutrale Rahmen, Fokusring-Indikatoren und Typografieskalen (accessible-color-system, elevation-and-depth-system, fluid-spacing-system).

Ausgaben

  1. Split-Pane-Layout-Spezifikation: CSS Grid / Flexbox räumliche Definitionen für feste vs. flüssige Pane-Proportionen, unabhängige vertikale Scroll-Container (overflow-y: auto) und visuelle Trennlinien.
  2. Blueprint für Master-Item-Auswahl & Aktivzustand: Visuelle Spezifikationen für ungelesene, gehoverte, fokussierte, ausgewählte (aria-selected="true") und Multi-Select-Checkbox-Zustände innerhalb der Liste.
  3. Hierarchie des Detail-Arbeitsbereichs & Header-Anatomie: Räumliches Layout für die Detailansicht-Aktionsleiste (sticky-Header, Zurück-Button, Statussteuerung, primäre/sekundäre Aktionsauslöser) und Inhaltsregisterkarten/-abschnitte.
  4. Responsives Viewport-Anpassungsmodell: Schritt-für-Schritt-Layout-Übergangsregeln, die von der Dual-Pane-Split-Ansicht auf Desktop/Laptop zur Single-Pane-Back-Stack-Navigation mit animierten Panel-Folien auf Tablet/Mobilbildschirmen wechseln.
  5. Zugängliches Tastatur- & ARIA-Interaktionsmodell: Focus Trapping, Roving tabindex oder APG-Listbox-Fokus-Routing, ARIA-Landmarken (role="region", aria-controls), und Screenreader-Statusmeldungen via aria-live="polite".

Arbeitsablauf

1. Einrichten des Dual-Pane-Canvas-Containers

Konstruieren des äußeren Master-Detail-Wrappers innerhalb der Anwendungsshell (dashboard-layout-system):

  • Container-Viewport-Sperrung: Setzen Sie den äußeren Wrapper auf display: flex; height: 100vh; max-height: 100vh; overflow: hidden; (oder passend innerhalb des übergeordneten Dashboard-Inhaltsbereichs), um die Gesamtlayouthöhe zu fixieren und Browser-Fenster-Scrollen zu eliminieren.
  • Split-Verhältnis-Spalten-Grid: Definieren Sie die Split-Pane-Proportion mittels CSS Grid oder Flexbox:
    • Festes Master-Muster (Empfohlen für Posteingänge/CRMs): grid-template-columns: minmax(300px, 380px) 1fr; (Der Master-Pane bleibt auf einer angenehmen Scan-Breite zwischen 300px und 380px; der Detail-Pane verbraucht den gesamten verbleibenden horizontalen Platz).
    • Proportionale Aufteilung: grid-template-columns: 35% 65%; oder 40% 60% für dichte Inspektionstools.
  • Visueller Pane-Trenner: Fügen Sie einen 1px durchgehenden Rahmen (border-right: 1px solid var(--border-subtle)) oder eine zugängliche, in der Größe veränderbare Split-Leiste (accessible-split-pane-implementation) zwischen den Panes ein.

2. Gestalten der Master-Listen-Pane-Struktur

Der Master-Pane dient als schnell scannbarer Index der Datensatzsammlung:

  • Sticky-Header-Bereich: Positionieren Sie eine fixierte Such- und Filtersteuerungsleiste oben im Master-Pane (flex-shrink: 0; padding: 12px 16px; border-bottom: 1px solid var(--border-subtle); background: var(--surface-card)). Fügen Sie ein Schnellsuchfeld (search-interface-system), Filter-Chips und Bulk-Aktion-Trigger hinzu.
  • Unabhängig scrollbare Item-Liste: Wickeln Sie die Listenelemente in einen Container mit flex: 1; overflow-y: auto; overflow-x: hidden; -webkit-overflow-scrolling: touch; (role="list" oder role="listbox").
  • Anatomie der Master-Item-Karte:
    1. Obere Reihe: Primäre Kennung / Autor (font-weight: 600; font-size: 0.875rem; color: var(--text-primary)), Status-Pill/Badge und Zeitstempel (font-size: 0.75rem; color: var(--text-muted)).
    2. Mittlere Reihe: Item-Betreff oder Titel (font-weight: 500; font-size: 0.875rem; color: var(--text-primary); text-truncate: 1 line).
    3. Untere Reihe: Ausschnitt oder Vorschautext (font-size: 0.8125rem; color: var(--text-secondary); line-clamp: 2), Tags/Kategorie und Bearbeiter-Avatar (user-avatar-system).
  • Zustandsstyling-Regeln:
    • Ungelesener / Unverarbeiteter Zustand: Fetter Titeltext mit einem subtilen visuellen Hinweis (z. B. 8x8px primärer Akzentpunkt auf der linken Seite).
    • Hover-Zustand: Hintergrundhervorhebung (background: var(--surface-hover); cursor: pointer).
    • Aktiver / Ausgewählter Zustand: Deutlich aktiver Oberflächenhintergrund (background: var(--surface-active-subtle)), ein 3px durchgehender primärer Akzentindikatorstreifen am linken Rand (border-left: 3px solid var(--brand-primary)) und aria-selected="true".
    • Sichtbarer Fokus-Zustand: Hochsichtbarer Fokus-Umriss (outline: 2px solid var(--focus-ring); outline-offset: -2px).

3. Erstellen der Detail-Arbeitsbereich-Pane-Struktur

Der Detail-Pane rendert den vollständigen Kontext und Arbeitsbereich des aktiven Datensatzes:

  • Leerzustandsanzeige: Wenn kein Datensatz im Master-Pane ausgewählt ist, zeigen Sie einen zugänglichen Leerzustand (empty-state-system) im Detail-Pane an, mit einem subtilen Icon, einer klaren Überschrift ("Kein Datensatz ausgewählt") und einem hilfreichen Hinweis ("Wählen Sie ein Element aus der Liste aus, um Details anzuzeigen").
  • Sticky-Detail-Aktionsleiste: Rendern Sie eine persistente obere Header-Leiste innerhalb des Detail-Pane (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)):
    • Mobiler Zurück-Trigger: Fügen Sie einen auf Desktop versteckten "Zurück zur Liste"-Button ein (<button class="mobile-back-btn">← Zurück</button>).
    • Datensatzidentifikation: Datensatz-ID / Titelzusammenfassung (font-weight: 600; font-size: 1rem).
    • Aktionssteuerung: Primäre Aktionsschaltflächen (z. B. "Antworten", "Bearbeiten", "Zuordnen", "Löschen"), gestaltet mit button-and-action-system.
  • Unabhängiger Inhalts-Scrollbereich: Wickeln Sie den Hauptdetailinhaltskörper in einen Scroll-Container (flex: 1; overflow-y: auto; padding: 24px).
  • Detailinhaltslayout:
    • Header-Abschnitt: H1-Datensatztitel, Status-Badge, Metadaten-Grid (Erstellungsdatum, Autor, Priorität, Bearbeiter).
    • Primärer Inhaltsbereich: Vollständige Beschreibung, HTML-Thread-Nachricht oder Konfigurationscodeblock.
    • Registerkarten-Unterabschnitte: Verwenden Sie Registerkarten (tab-ui-system) zur Trennung von "Aktivitätsverlauf", "Anhänge", "Prüfprotokolle" und "Zugehörige Datensätze".

4. Implementieren der responsiven Zurück-Stapel-Navigation für Mobilgeräte & Tablets

Auf Bildschirmen schmaler als 768px (oder 1024px für dichte Apps) führt die nebeneinander Anzeige von Panes zu unlesbaren, gequetschtem Text und eingezwängten Buttons. Wandeln Sie das Layout in ein Single-Pane-Back-Stack-Modell um:

  • Mobile Single-Pane-Ansicht: Rendern Sie jeweils nur einen Pane in voller Viewport-Breite (width: 100%).
  • Zustandsmaschine der Navigation:
    • Zustand A (Master aktiv): Der Master-Listen-Pane belegt 100 % Breite. Der Detail-Pane ist visuell versteckt (display: none oder mit transform: translateX(100%) außerhalb des Bildschirms verschoben).
    • Zustand B (Detail aktiv): Wenn der Benutzer auf ein Master-Element tippt, wechseln Sie die Ansicht. Der Detail-Pane belegt 100 % Breite, und der Master-Pane ist versteckt.
  • Mobiler Zurück-Button: Im Zustand B zeigt der Detail-Pane einen prominenten "Zurück zur Liste"-Button oben links an. Ein Tippen setzt die Zustandsmaschine zurück zu Zustand A und gibt den Tastaturfokus auf das zuvor ausgewählte Master-Listenelement zurück.
  • Viewport-Animation: Verwenden Sie sanfte gleitende Ansichtsübergänge (view-transitions-implementation oder horizontale CSS-Transformationen transform 0.25s ease-in-out), um die Richtungsorientierung zu verstärken (nach links in Detail gleiten, nach rechts zurück zur Master-Liste gleiten).

5. Sicherstellen von zugänglichem Fokus & Screenreader-Interaktion

  • ARIA-Landmarken & Bereichsrollen: Weisen Sie role="region" aria-label="Item-Liste" dem Master-Pane-Container und role="region" aria-label="Item-Detail-Arbeitsbereich" dem Detail-Pane-Container zu.
  • Listbox / Auswahl-Markup: Wenn sich die Master-Liste wie ein Single-Selection-Widget verhält, wenden Sie role="listbox" aria-label="..." auf die Liste und role="option" aria-selected="true|false" auf die Listenelemente an. Alternativ verwenden Sie ein standard <nav> mit aria-current="page" oder aria-current="true".
  • Fokusmanagement bei Datensatzauswahl: Wenn ein Benutzer ein Master-Element mit Tastatur oder Zeiger auswählt:
    • Behalten Sie den Tastaturfokus innerhalb der Master-Liste, wenn der Benutzer schnell mit Pfeiltasten (Auf / Ab) scannt.
    • Aktualisieren Sie den Detail-Pane-DOM asynchron und kündigen Sie das Laden des Datensatzes über einen aria-live="polite"-Statusbereich an: "Geladener Ticket #1042: Zahlungsabwicklungsfehler".
    • Wenn der Benutzer Enter oder Tab von einem ausgewählten Listenelement drückt, verschieben Sie den Fokus nahtlos zur primären Aktion oder zum Header H1 des Detail-Pane (tabindex="-1").
  • Mobile Viewport-Fokusfalle & Wiederherstellung: Beim Wechsel zur Detailansicht auf Mobilgeräten verschieben Sie den Fokus automatisch zum mobilen Zurück-Button oder zum Detail-Header. Bei der Rückkehr zur Masteransicht stellen Sie den Fokus auf das zuvor aktive Master-Element wieder her.

Entscheidungsregeln

Pane-Layout & Split-Strategie

Viewport-BreiteEmpfohlenes Layout-MusterMaster-Pane-BreiteDetail-Pane-Breite
Breiter Desktop (>1280px)Dual-Pane-Split-Ansicht (oder 3-Pane mit Seitenleiste)Fest 360px - 400pxFlüssig flex: 1 (min-width: 600px)
Standard Desktop (1024px - 1279px)Dual-Pane-Split-AnsichtFest 320px - 350pxFlüssig flex: 1 (min-width: 480px)
Tablet (768px - 1023px)Schmales Dual-Pane ODER Single-Pane-StapelFest 280px - 300px (oder einklappbar)Flüssig flex: 1
Mobilgerät (<768px)Single-Pane-Back-Stack-Ansicht100% (Zustand A)100% (Zustand B)

Master-Listen-Auswahl vs. Fokus-Modell

  • Auto-Auswahl bei Fokus (Schnelles Scannen): Das Drücken der Auf- oder Ab-Pfeiltasten ändert sofort die aktive Auswahl und aktualisiert den Detail-Pane in Echtzeit. Empfohlen für das Lesen von E-Mails, die Prüfung von Protokollen und das Screening von großen Ticketmengen.
  • Explizite Auswahl bei Aktion (Drücken von Enter / Klicken): Das Navigieren durch Master-Elemente mit Pfeiltasten bewegt einen visuellen Fokusring, ohne den Detail-Pane zu aktualisieren. Der Detail-Pane wird nur aktualisiert, wenn der Benutzer explizit Enter, Leertaste drückt oder klickt. Empfohlen, wenn das Laden von Detaildatensätzen schwere Netzwerk-API-Anfragen oder Formularstatusbearbeitung umfasst.

Einschränkungen

  • Zugänglichkeit (WCAG 2.1 AA):
    • SC 2.1.1 Tastatur: Benutzer müssen in der Lage sein, mit reinem Tastatur-Steuerung durch Master-Elemente zu scrollen, Datensätze auszuwählen, in den Detail-Arbeitsbereich zu navigieren, Aktionen auszulösen und zur Master-Liste zurückzukehren.
    • SC 2.4.7 Sichtbarer Fokus: Aktive und fokussierte Master-Elemente müssen einen nicht beschnittenen Fokusring aufweisen, der ein Mindestkontrastverhältnis von 3:1 zum Hintergrund erfüllt.
    • SC 4.1.2 Name, Rolle, Wert: Master-Elemente müssen ihren aktiven/ausgewählten Status der unterstützenden Technologie explizit über aria-selected="true" oder aria-current="true" mitteilen.
    • SC 2.5.8 Zielgröße: Antippziele auf Master-Listenelementen und Detail-Aktionsschaltflächen müssen eine Mindestzielfläche von 24x24px (44x44px bevorzugt auf mobilen Touch-Displays) bieten.
  • Layout-Eindämmung & CLS: Der äußere Master-Detail-Container muss die Gesamthöhe begrenzen, damit Seiteninhalte das Browser-Fenster nicht überschreiten. Verwenden Sie height: 100vh; max-height: 100vh; overflow: hidden;, um kumulative Layout-Verschiebungen (CLS) zu vermeiden, die durch dynamisch geladene Detailinhalte verursacht werden könnten.

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.

Verwandte Skills