MasterDetailLayout
Seitengerüst wie Outlook im Web: Kopf (etwa eine CommandBar) über die ganze Breite, darunter Navigation | Liste | Detail mit
verschiebbaren Trennern (Breiten im Browser gespeichert über SaveStateName). Die Stufen richten sich nach der Breite des Layouts:
bis 64rem steht die Navigation im Drawer, bis 48rem bleibt eine Spalte mit der Liste oder dem geöffneten Detail. In RailLayout, SidebarLayout
und TopNavLayout füllt es den Inhaltsbereich; ein offener Drawer liegt dort über Kopfzeile und Leiste.
Dreiteilig: Ordner, Liste, Lesen
Ordner | Liste | Lesen wie Outlook im Web. Die Breite des Rahmens verkleinern: unter 64rem wandert die Navigation in einen Drawer (Menüknopf), unter 48rem bleibt eine Spalte – die Liste oder die geöffnete Nachricht.
Zweiteilig: Navigation und Inhalt
Zweiteilig wie ein Kalender: Navigation links, daneben der Inhalt als Karte. FixedHeightWhenSingleColumn behält auch in einer Spalte die Höhe; der Inhalt scrollt selbst.
Donnerstag, 19. November 2026
Hier steht die Ansicht, etwa ein Scheduler.
SKILL.md – Masterdetaillayout
---
name: MasterDetailLayout
description: Onesown Blazor Komponente MasterDetailLayout (FlexGrid). Verwende diesen Skill wenn du die MasterDetailLayout-Komponente verwenden, konfigurieren oder debuggen moechtest.
---
# MasterDetailLayout
**Namespace:** `Onesown.Blazor.Components`
**Kategorie:** FlexGrid
**Basisklasse:** `OoComponentBase`
Seitengerüst wie Outlook im Web mit bis zu drei Bereichen: Navigation (etwa Ordner) | Liste | Detail (Lesen), darüber optional eine Befehlsleiste. Trenner per Splitter mit im Browser gespeicherten Breiten; je nach eigener Breite wandert die Navigation in einen Drawer und am Ende bleibt eine Spalte, die die Liste oder das geöffnete Detail zeigt. Auch zweiteilig (Navigation | Inhalt, etwa ein Kalender) nutzbar.
**Live-Demo:** https://components.schini.com/demo/masterdetaillayout
## Parameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Header`` | ``RenderFragment`` | | Kopfbereich über die ganze Breite, typischerweise eine CommandBar. In der einen Spalte flach mit Linie darunter. |
| ``Navigation`` | ``RenderFragment`` | | Linke Spalte, etwa Ordner oder Kalenderauswahl. Bis DrawerBreakpoint im Drawer (NavigationOpen). Ohne Angabe keine Navigationsspalte. |
| ``List`` | ``RenderFragment`` | | Mittlere Spalte (weiß), etwa die Mailliste. Mit List gibt es Liste | Detail, sonst füllt ChildContent den Bereich. |
| ``Detail`` | ``RenderFragment`` | | Rechte Spalte neben der Liste (grau), etwa die gelesene Mail oder ein Platzhalter „Nichts ausgewählt“. Nur zusammen mit List. |
| ``ChildContent`` | ``RenderFragment`` | | Inhalt neben der Navigation, wenn es keine Liste gibt (zweiteilig, etwa ein Kalender). Als weiße Karte. |
| ``DetailOpen`` | ``bool`` | | Ob ein Detail geöffnet ist. In der einen Spalte und bei ShowDetailPane="false" zeigt das Layout dann das Detail statt der Liste. Standard: false. |
| ``ShowDetailPane`` | ``bool`` | ``true`` | Detail rechts neben der Liste. false („Lesebereich aus“): Liste über die ganze Breite, ein geöffnetes Detail ersetzt sie. Standard: true. |
| ``NavigationOpen`` | ``bool`` | | Ob der Drawer mit der Navigation offen ist (nur bis DrawerBreakpoint sinnvoll). Für @bind-NavigationOpen. Standard: false. |
| ``NavigationOpenChanged`` | ``EventCallback<bool>`` | | Wird aufgerufen, wenn der Drawer der Navigation auf- oder zugeht (Schließen-X, Escape, Hintergrund, Navigation). Für @bind-NavigationOpen. |
| ``NavigationTitle`` | ``string`` | ``"Navigation"`` | Titel des Drawers und zugänglicher Name der Navigationsspalte. Standard: "Navigation". |
| ``NavigationDrawerWidth`` | ``string`` | ``"20rem"`` | Breite des Drawers der Navigation als CSS-Wert. Standard: "20rem". |
| ``CloseNavigationOnNavigate`` | ``bool`` | ``true`` | Ob jede Navigation (etwa die Wahl eines Ordners) den Drawer schließt. Standard: true. |
| ``DrawerBreakpoint`` | ``string`` | ``"64rem"`` | Breite des Layouts, bis zu der die Navigation im Drawer statt als Spalte steht. CSS-Länge in rem, em oder px. Standard: "64rem". |
| ``SingleColumnBreakpoint`` | ``string`` | ``"48rem"`` | Breite des Layouts, bis zu der nur eine Spalte zu sehen ist (Liste oder Detail). CSS-Länge in rem, em oder px. Standard: "48rem". |
| ``SaveStateName`` | ``string`` | | Schlüssel, unter dem die Breiten der Trenner im Browser gespeichert werden ("…-navigation", "…-list"). Ohne Angabe werden sie nicht gemerkt. |
| ``NavigationSize`` | ``double`` | ``16`` | Startbreite der Navigationsspalte in Prozent. Standard: 16. |
| ``NavigationMinSize`` | ``int`` | ``170`` | Mindestbreite der Navigationsspalte beim Ziehen in Pixel. Standard: 170. |
| ``MainMinSize`` | ``int`` | ``420`` | Mindestbreite des Bereichs neben der Navigation beim Ziehen in Pixel. Standard: 420. |
| ``ListSize`` | ``double`` | ``36`` | Startbreite der Liste in Prozent des Bereichs aus Liste und Detail. Standard: 36. |
| ``ListMinSize`` | ``int`` | ``300`` | Mindestbreite der Liste beim Ziehen in Pixel. Standard: 300. |
| ``DetailMinSize`` | ``int`` | ``320`` | Mindestbreite des Details beim Ziehen in Pixel. Standard: 320. |
| ``ListLabel`` | ``string`` | ``"Liste"`` | Zugänglicher Name der Liste (aria-label). Standard: "Liste". |
| ``DetailLabel`` | ``string`` | ``"Detail"`` | Zugänglicher Name des Details (aria-label). Standard: "Detail". |
| ``HideHeaderWhenSingleColumn`` | ``bool`` | | Blendet den Header in der einen Spalte aus, etwa wenn die Seite am Handy eigene Knöpfe hat. Standard: false. |
| ``FixedHeightWhenSingleColumn`` | ``bool`` | | Behält in der einen Spalte die volle Höhe, statt mit dem Inhalt zu wachsen; der Inhalt scrollt dann selbst (etwa ein Kalender). Standard: false. |
| ``Height`` | ``string`` | | Höhe des Layouts als CSS-Wert, etwa "calc(100dvh - 4rem)". Standard: Inhaltshöhe des umgebenden App-Layouts, sonst 100 %. |
## Geerbte Parameter (OoComponentBase)
Alle nicht deklarierten HTML-Attribute (``class``, ``style``, ``data-*``, ``aria-*``, ...) werden an das Root-Element weitergereicht.
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Size`` | ``string`` | | Größe der Komponente. Mögliche Werte: OoSize.Xs, OoSize.Sm, OoSize.Md, OoSize.Lg, OoSize.Xl. Wird als CSS-Klasse am Root-Element gesetzt. |
## Hinweise
- Natives HTML-Attribut class wird automatisch an das Root-Element weitergegeben
- Natives HTML-Attribut style wird automatisch an das Root-Element weitergegeben
- Alle weiteren nicht deklarierten Attribute (data-*, aria-*, id, tabindex, …) werden ebenfalls weitergereicht
- Größe der Komponente via Size mit OoSize-Konstanten steuern (OoSize.Xs bis OoSize.Xl)
- Dreiteilig: <MasterDetailLayout SaveStateName="post" DetailOpen="@(_mail != null)" @bind-NavigationOpen="_ordnerOffen"> mit Header (etwa CommandBar), Navigation, List und Detail
- Zweiteilig: Navigation und ChildContent statt List/Detail; ohne Navigation nur Liste | Detail bzw. nur der Inhalt
- Stufen nach der Breite des Layouts (Container-Abfrage): über DrawerBreakpoint (Standard 64rem) alle Spalten; bis dahin steht die Navigation im Drawer (@bind-NavigationOpen, Knopf dafür mit class="oo-mdl-show-drawer"); bis SingleColumnBreakpoint (Standard 48rem) eine Spalte: Liste oder, bei DetailOpen="true", das Detail
- ShowDetailPane="false" („Lesebereich aus“): Liste über die ganze Breite, ein geöffnetes Detail (DetailOpen) ersetzt sie
- Sichtbarkeit je Stufe für eigene Elemente im Layout: class="oo-mdl-show-drawer" (nur wenn die Navigation im Drawer steht), "oo-mdl-show-wide" (nur mit Navigationsspalte), "oo-mdl-show-single" bzw. "oo-mdl-hide-single" (nur bzw. nicht in der einen Spalte)
- Breiten speichern: SaveStateName="post" merkt die Trenner im Browser unter "post-navigation" und "post-list"; Startbreiten über NavigationSize und ListSize (Prozent)
- Höhe: füllt den Inhaltsbereich von RailLayout, SidebarLayout und TopNavLayout (deren --oo-*-content-height), sonst 100 %; eigene Höhe über Height. In der einen Spalte wächst das Layout mit dem Inhalt über seine Höhe hinaus und die Seite scrollt – es gehört deshalb allein in den Inhaltsbereich, ohne Inhalt darunter; FixedHeightWhenSingleColumn="true" behält die Höhe (Inhalt mit eigenem Scrollen, etwa ein Kalender)
- Navigation nur einmal: Solange der Drawer offen ist, steht sie nur dort, sonst nur in der Spalte – nie zwei Instanzen gleichzeitig (Zustand im Inhalt, etwa aufgeklappte Knoten, beginnt beim Wechsel neu)
- Drawer: Der Drawer der Navigation steht neben dem Layout; seit dieser Version heben RailLayout, SidebarLayout und TopNavLayout ihren Inhaltsbereich über Kopfzeile und Leiste, solange darin ein Drawer mit Hintergrund offen ist – kein SectionContent außerhalb des Layouts nötig
- Flächen: Hintergrund grau (--oo-color-background), Liste weiß, Detail grau für Inhalt als Card; Liste und Detail bzw. der Inhalt als Karte mit runden Ecken und leichtem Schatten. Liste und Detail sind Container (oo-mdl-list, oo-mdl-detail) für eigene Container-Abfragen, etwa Liste als Tabelle
- Die Bereiche (Navigation, Liste/Detail) sollten zur Laufzeit nicht wechseln; tun sie es doch, baut das Layout seine Splitter neu auf