SidebarLayout

SidebarLayout

Grundgerüst einer Anwendung: Seitenleiste links, scrollender Inhalt rechts. Ist das Layout schmaler als 48rem, wird die Seitenleiste zur Schublade, die ein Menüknopf in der Kopfzeile öffnet. Die Komponente ist als äußerstes Element im MainLayout gedacht, deshalb wird sie hier als eigenes Layout gezeigt und nicht in der Seite eingebettet.

Live ansehen

Schaltet die Demo auf das Layout „SidebarLayout“ um (auch über den Layout-Umschalter oben). Fenster schmal ziehen, um die Schublade zu sehen.

Aktives Layout: SidebarComponentLayout

Aufbau im MainLayout

Sidebar für die Seitenleiste (ein einzelnes Kind füllt ihre Höhe), HeaderActions für Knöpfe der schmalen Kopfzeile, @Body in ChildContent. Ein Stack mit StretchItems.Middle und Scroll="true" hält Kopf und Fuß der Seitenleiste fest und lässt die Liste dazwischen scrollen.

<SidebarLayout Title="Meine App">
    <Sidebar>
        <Stack Orientation="OoOrientation.Vertical" StretchItems="OoStretchItems.Middle">
            <strong>Meine App</strong>
            <Stack Orientation="OoOrientation.Vertical" Scroll="true">
                <CollapseNavMenu Items="_items" />
            </Stack>
            <ContextMenu Position="top" FullWidth="true">…</ContextMenu>
        </Stack>
    </Sidebar>
    <HeaderActions>
        <Button Icon="add" Title="Neu" ButtonStyle="OoColorPalette.Neutral.Ghost" />
    </HeaderActions>
    <ChildContent>@Body</ChildContent>
</SidebarLayout>
<Toaster />
<DialogHost />

Parameter & CSS-Variablen

SidebarWidth (Standard 16.25rem), @bind-SidebarOpen (optional), CloseOnNavigation (Standard true), MenuButtonTitle. Am Inhaltsbereich stehen --oo-sbl-header-offset und --oo-sbl-content-height für klebende Elemente und bildschirmfüllende Seiten bereit.

<SidebarLayout Title="Meine App"
               SidebarWidth="18rem"
               @bind-SidebarOpen="_menueOffen"
               CloseOnNavigation="false"
               MenuButtonTitle="Navigation öffnen"
               class="meine-app" style="--oo-sbl-header-height: 3.5rem; --oo-sbl-backdrop: rgb(0 0 0 / 0.4)">
    …
</SidebarLayout>

@* Im Inhalt: klebende Leiste unter der Kopfzeile, Seite füllt den sichtbaren Bereich *@
<div style="position: sticky; top: var(--oo-sbl-header-offset)">…</div>
<div style="min-height: var(--oo-sbl-content-height)">…</div>

Ohne Bindung verwaltet das Layout den Zustand der Schublade selbst. Mit @bind-SidebarOpen lässt sie sich auch aus der Anwendung öffnen, etwa _menueOffen = true nach einem Klick auf einen eigenen Knopf.

Seitenpanel rechts & verstellbare Breiten

Aside zeigt ein Panel rechts neben dem Inhalt, solange AsideOpen true ist. Breit ist es eine eigene Spalte, die für sich scrollt; schmal liegt es rechts über dem Inhalt. Mit einem SectionOutlet füllt es die jeweilige Seite – live zu sehen in der SectionContent-Demo. Resizable="true" setzt Ziehgriffe auf die Grenzen von Seitenleiste und Seitenpanel (auch mit Pfeiltasten, Doppelklick setzt zurück); SaveStateName speichert die Breiten im Browser. Live in den Layouts „Flyout Splitter“ und „Dual Panel“.

<SidebarLayout AsideOpen="_panelOffen" AsideWidth="24rem" AsideLabel="Details"
               Resizable="true" SaveStateName="meine-app">
    <Sidebar>…</Sidebar>
    <Aside><SectionOutlet SectionName="sidepanel" /></Aside>
    <ChildContent>@Body</ChildContent>
</SidebarLayout>

Bedienung & Barrierefreiheit

Im Layout „SidebarLayout“ bei schmalem Fenster ausprobieren.

  • Der Menüknopf in der Kopfzeile öffnet die Schublade, meldet den Zustand per aria-expanded und setzt den Fokus in die Seitenleiste.
  • Escape schließt die Schublade und gibt den Fokus an den Menüknopf zurück; ebenso schließt ein Klick auf den Schleier daneben.
  • Jede Navigation schließt die Schublade, außer bei CloseOnNavigation="false".
  • Geschlossen ist die Seitenleiste unsichtbar und wird von Tab übersprungen.
  • Auf Touch-Geräten bis 48rem Breite scrollt die Seite statt des Inhaltsbereichs, die Kopfzeile klebt oben.
SKILL.md – Sidebarlayout
---
name: SidebarLayout
description: Onesown Blazor Komponente SidebarLayout (FlexGrid). Verwende diesen Skill wenn du die SidebarLayout-Komponente verwenden, konfigurieren oder debuggen moechtest.
---

# SidebarLayout

**Namespace:** `Onesown.Blazor.Components`  
**Kategorie:** FlexGrid  
**Basisklasse:** `OoComponentBase`  

Grundgerüst einer Anwendung mit Seitenleiste links und scrollendem Inhalt rechts. Ist das Layout schmal, wird die Seitenleiste zur Schublade, die sich über den Inhalt schiebt; eine Kopfzeile mit Menüknopf, Titel und Aktionen öffnet sie. Am Handy scrollt die Seite statt des Inhaltsbereichs, damit der Browser Adressleiste und Bildschirmtastatur richtig behandelt.

**Live-Demo:** https://components.schini.com/demo/sidebarlayout  

## Parameter

| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Sidebar`` | ``RenderFragment`` |  | Inhalt der Seitenleiste, etwa Navigation, Liste der Einträge und Benutzermenü. Hintergrund, Rahmen und Innenabstand setzt das Layout. |
| ``ChildContent`` | ``RenderFragment`` |  | Inhalt rechts neben der Seitenleiste, im MainLayout @Body. Scrollt im Layout, am Handy mit der Seite. |
| ``Title`` | ``string`` |  | Titel in der Kopfzeile der schmalen Ansicht, mittig zwischen Menüknopf und Aktionen; bei Überlänge mit „…“ gekürzt. |
| ``HeaderActions`` | ``RenderFragment`` |  | Knöpfe rechts in der Kopfzeile der schmalen Ansicht, etwa „Neu“. In der breiten Ansicht nicht sichtbar. |
| ``SidebarOpen`` | ``bool`` |  | Ob die Seitenleiste in der schmalen Ansicht als Schublade eingeblendet ist. In der breiten Ansicht ohne Wirkung. Standard: false. |
| ``SidebarOpenChanged`` | ``EventCallback<bool>`` |  | Wird aufgerufen, wenn die Schublade geöffnet oder geschlossen wird (Menüknopf, Klick daneben, Navigation). Für @bind-SidebarOpen. |
| ``SidebarWidth`` | ``string`` |  | Breite der Seitenleiste als CSS-Wert, etwa "18rem". Höchstens 85 % des Layouts, damit neben der Schublade noch Inhalt zu sehen ist. Standard: 16.25rem. |
| ``Aside`` | ``RenderFragment`` |  | Inhalt eines Seitenpanels rechts neben dem Inhalt, etwa Details oder Eigenschaften zur Auswahl. Sichtbar nur, solange AsideOpen true ist. Mit einem SectionOutlet füllt ihn die jeweilige Seite. |
| ``AsideOpen`` | ``bool`` |  | Ob das Seitenpanel Aside angezeigt wird. Die Anwendung öffnet und schließt es selbst. Standard: false. |
| ``AsideWidth`` | ``string`` |  | Breite des Seitenpanels als CSS-Wert, etwa "24rem". Höchstens 85 % des Layouts. Standard: min(35rem, 38%). |
| ``AsideLabel`` | ``string`` | ``"Seitenpanel"`` | Zugänglicher Name des Seitenpanels für Screenreader. Standard: "Seitenpanel". |
| ``Resizable`` | ``bool`` |  | Ob Seitenleiste und Seitenpanel in der breiten Ansicht per Ziehgriff breiter und schmaler gezogen werden können. Standard: false. |
| ``SaveStateName`` | ``string`` |  | Schlüssel, unter dem der Browser (localStorage) die gezogenen Breiten speichert. Ohne Angabe gelten sie nur bis zum Neuladen. Nur mit Resizable. |
| ``MenuButtonTitle`` | ``string`` | ``"Menü anzeigen"`` | Tooltip und zugänglicher Name des Menüknopfs in der Kopfzeile. Standard: "Menü anzeigen". |
| ``CloseOnNavigation`` | ``bool`` | ``true`` | Ob jede Navigation die Schublade schließt, etwa nach der Wahl eines Eintrags in der Seitenleiste. Standard: true. |

## 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)
- Einsatz im MainLayout als äußerstes Element: Seitenleiste in <c>Sidebar</c>, Knöpfe der Kopfzeile in <c>HeaderActions</c>, <c>@Body</c> in <c>ChildContent</c>; Toaster und DialogHost daneben.
- Schmal heißt: das Layout selbst ist höchstens 48rem breit (Container-Abfrage, nicht die Fensterbreite). So bleibt die Schublade im Layout, auch wenn es als Panel neben einer anderen Anwendung steht.
- Es scrollen nur der Inhalt (<c>.oo-sbl__main</c>) und, was die Anwendung in der Seitenleiste scrollen lässt, nie die Seite. Ausnahme: Touch-Geräte bis 48rem Breite oder im Querformat (bis 30rem Höhe und 60rem Breite); dort scrollt die Seite, die Kopfzeile klebt oben und die Seitenleiste liegt fest über der Seite. Nur so klappt der Browser die Adressleiste ein und hält das fokussierte Eingabefeld über der Tastatur.
- Für Inhalte, die sich danach richten müssen, setzt das Layout am Inhaltsbereich zwei CSS-Variablen: <c>--oo-sbl-header-offset</c> (Höhe der klebenden Kopfzeile, wenn die Seite scrollt, sonst 0; etwa für <c>top</c> klebender Elemente oder <c>scroll-margin-top</c>) und <c>--oo-sbl-content-height</c> (sichtbare Höhe des Inhalts; für <c>min-height</c> einer Seite, die den Bildschirm füllen soll). Eigene Scrollbereiche im Inhalt setzen beide bei Bedarf zurück.
- Jede Navigation schließt die Schublade (abschaltbar mit <c>CloseOnNavigation="false"</c>), ebenso ein Klick neben sie und Escape, solange der Fokus in der Seitenleiste steht.
- Barrierefreiheit: Der Menüknopf meldet den Zustand über <c>aria-expanded</c> und verweist mit <c>aria-controls</c> auf die Seitenleiste. Öffnet er die Schublade, springt der Fokus in die Seitenleiste; Escape schließt sie und gibt den Fokus an den Menüknopf zurück.
- <c>SidebarOpen</c> ist optional bindbar (<c>@bind-SidebarOpen</c>); ohne Bindung verwaltet das Layout den Zustand selbst.
- Besteht <c>Sidebar</c> aus einem einzigen Element, füllt es die Höhe der Seitenleiste (etwa ein Stack mit <c>JustifyContent.SpaceBetween</c>, um Benutzermenü und Einstellungen unten zu halten).
- Optionales Seitenpanel rechts: Inhalt in <c>Aside</c>, sichtbar mit <c>AsideOpen="true"</c>. Breit steht es als eigene Spalte neben dem Inhalt und scrollt für sich; schmal liegt es rechts über dem Inhalt. Schließen muss die Anwendung, etwa nach einer Navigation.
- Verstellbare Breiten: Mit <c>Resizable="true"</c> stehen auf den Grenzen von Seitenleiste und Seitenpanel Ziehgriffe (Maus, Touch, Pfeiltasten; Doppelklick stellt die Ausgangsbreite wieder her). Breiten zwischen 10rem und der Hälfte des Layouts; mit <c>SaveStateName</c> merkt sich der Browser sie. In der schmalen Ansicht gibt es keine Ziehgriffe.
- Farben: Seitenleiste im Hintergrund (<c>--oo-color-background</c>, leicht grau), Inhalt auf der Fläche (<c>--oo-color-surface</c>, weiß). Darauf sind Card (getönter Kopf und Footer), List (Streifen, Hover) und Tabs abgestimmt; nicht in der Anwendung umdrehen.
- Breite der Seitenleiste über <c>SidebarWidth</c> (Standard 16.25rem, höchstens 85 % des Layouts), Höhe der Kopfzeile über die CSS-Variable <c>--oo-sbl-header-height</c> (Standard 3rem).


Die Verbindung zum Server ist unterbrochen. Verbinde neu …

Neu verbinden hat nicht geklappt. Nächster Versuch in Sekunden.

Keine Verbindung zum Server. Bitte erneut versuchen oder die Seite neu laden.

Der Server hat die Sitzung angehalten.

Die Sitzung ließ sich nicht fortsetzen. Bitte erneut versuchen oder die Seite neu laden.