SidebarLayout

TopNavLayout

Grundgerüst einer Anwendung: Navigation in einer Kopfzeile oben, darunter der Inhalt über die volle Breite – für Seiten, die viel Platz brauchen, etwa Boards. Der Inhalt füllt den Rest der Höhe; bricht die Navigation um, wird die Kopfzeile höher. Ist das Layout schmaler als 48rem, klappt die Navigation hinter einen Menüknopf ein. 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 „TopNavLayout“ um (auch über den Layout-Umschalter oben). Fenster schmal ziehen, um den Menüknopf zu sehen.

Aktives Layout: SidebarComponentLayout

Aufbau im MainLayout

Brand links, Navigation in der Mitte, Actions rechts, @Body in ChildContent. Brand und Actions bleiben auch schmal sichtbar; dort nur wenige, kleine Knöpfe hineinlegen. Für die Navigation passen SmartLinks in einem Stack (mit eigener Aktiv-Logik, etwa für Unterseiten) oder ein FlyoutMenu.

<TopNavLayout>
    <Brand>
        <SmartLink Href="/"><strong>Meine App</strong></SmartLink>
    </Brand>
    <Navigation>
        <Stack Wrap="OoWrap.Wrap" Gap="@OoSpace.S1">
            <SmartLink Href="/aufgaben" Text="Aufgaben" Icon="task_alt" AsButton="true" ButtonStyle="OoColorPalette.Neutral.Ghost" />
            <SmartLink Href="/issues" Text="Issues" Icon="adjust" AsButton="true" ButtonStyle="OoColorPalette.Neutral.Ghost" />
        </Stack>
    </Navigation>
    <Actions>
        <Button Icon="add" Title="Neu" ButtonStyle="OoColorPalette.Neutral.Ghost" />
        <ContextMenu>…</ContextMenu>
    </Actions>
    <ChildContent>@Body</ChildContent>
</TopNavLayout>
<Toaster />
<DialogHost />

Parameter & CSS-Variablen

@bind-MenuOpen (optional), CloseOnNavigation (Standard true), MenuButtonTitle. Am Inhaltsbereich stehen --oo-tnl-header-offset und --oo-tnl-content-height für klebende Elemente und bildschirmfüllende Seiten bereit; --oo-tnl-header-height setzt die Mindesthöhe der Kopfzeile (Standard 3rem).

<TopNavLayout @bind-MenuOpen="_menueOffen"
              CloseOnNavigation="false"
              MenuButtonTitle="Navigation öffnen"
              class="meine-app" style="--oo-tnl-header-height: 3.5rem; --oo-tnl-backdrop: rgb(0 0 0 / 0.4)">
    …
</TopNavLayout>

@* Im Inhalt: ein Board füllt genau den sichtbaren Bereich unter der Kopfzeile *@
<div style="height: var(--oo-tnl-content-height)">…</div>
<div style="position: sticky; top: var(--oo-tnl-header-offset)">…</div>

Bedienung & Barrierefreiheit

Im Layout „TopNavLayout“ bei schmalem Fenster ausprobieren.

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

# TopNavLayout

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

Grundgerüst einer Anwendung mit Navigation in einer Kopfzeile oben und dem Inhalt darunter über die volle Breite – für Seiten, die viel Platz brauchen, etwa Boards. Der Inhalt füllt den Rest der Höhe und scrollt; die Kopfzeile wächst mit, wenn die Navigation umbricht. Ist das Layout schmal, klappt die Navigation unter die Kopfzeile ein und ein Menüknopf öffnet sie.

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

## Parameter

| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Brand`` | ``RenderFragment`` |  | Links in der Kopfzeile, etwa Logo und Name der Anwendung als Link zur Startseite. Immer sichtbar. |
| ``Navigation`` | ``RenderFragment`` |  | Navigation in der Kopfzeile zwischen Brand und Actions, etwa SmartLinks in einem Stack oder ein FlyoutMenu. Schmal eingeklappt hinter dem Menüknopf. |
| ``Actions`` | ``RenderFragment`` |  | Knöpfe rechts in der Kopfzeile, etwa „Neu“, Einstellungen und Benutzermenü. Immer sichtbar. |
| ``ChildContent`` | ``RenderFragment`` |  | Inhalt unter der Kopfzeile, im MainLayout @Body. Füllt den Rest der Höhe und scrollt, am Handy mit der Seite. |
| ``MenuOpen`` | ``bool`` |  | Ob die eingeklappte Navigation in der schmalen Ansicht geöffnet ist. In der breiten Ansicht ohne Wirkung. Standard: false. |
| ``MenuOpenChanged`` | ``EventCallback<bool>`` |  | Wird aufgerufen, wenn die eingeklappte Navigation geöffnet oder geschlossen wird (Menüknopf, Klick daneben, Navigation). Für @bind-MenuOpen. |
| ``MenuButtonTitle`` | ``string`` | ``"Menü anzeigen"`` | Tooltip und zugänglicher Name des Menüknopfs in der schmalen Ansicht. Standard: "Menü anzeigen". |
| ``CloseOnNavigation`` | ``bool`` | ``true`` | Ob jede Navigation die eingeklappte Navigation schließt, etwa nach der Wahl eines Eintrags. 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: Logo und Name in <c>Brand</c>, Menü in <c>Navigation</c> (etwa SmartLinks in einem Stack oder ein FlyoutMenu), Knöpfe rechts in <c>Actions</c>, <c>@Body</c> in <c>ChildContent</c>; Toaster und DialogHost daneben.
- <c>Brand</c> und <c>Actions</c> bleiben immer sichtbar, auch in der schmalen Ansicht; dort gehören nur wenige, kleine Knöpfe hinein (etwa „Neu“ und das Benutzermenü als Avatar).
- Schmal heißt: das Layout selbst ist höchstens 48rem breit (Container-Abfrage, nicht die Fensterbreite). Dann zeigt die Kopfzeile links den Menüknopf; die Navigation liegt eingeklappt darunter und schiebt sich geöffnet über den Inhalt. Inhalte, die sich danach richten sollen, fragen mit einer Container-Abfrage auf <c>.oo-tnl</c> ab.
- Es scrollt nur der Inhalt (<c>.oo-tnl__main</c>), 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 Navigation ist immer eingeklappt, damit die Kopfzeile genau eine Zeile hoch bleibt. 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-tnl-header-offset</c> (Höhe der klebenden Kopfzeile, wenn die Seite scrollt, sonst 0; etwa für <c>top</c> klebender Elemente) und <c>--oo-tnl-content-height</c> (sichtbare Höhe des Inhalts; für <c>height</c> oder <c>min-height</c> einer Seite, die den Bildschirm füllen soll, etwa ein Board).
- Jede Navigation schließt die eingeklappte Navigation (abschaltbar mit <c>CloseOnNavigation="false"</c>), ebenso ein Klick daneben und Escape, solange der Fokus in ihr steht.
- Barrierefreiheit: Der Menüknopf meldet den Zustand über <c>aria-expanded</c> und verweist mit <c>aria-controls</c> auf die Navigation. Öffnet er sie, springt der Fokus hinein; Escape schließt sie und gibt den Fokus an den Menüknopf zurück.
- <c>MenuOpen</c> ist optional bindbar (<c>@bind-MenuOpen</c>); ohne Bindung verwaltet das Layout den Zustand selbst.
- Farben wie beim SidebarLayout: Kopfzeile im Hintergrund (<c>--oo-color-background</c>, leicht grau), Inhalt auf der Fläche (<c>--oo-color-surface</c>, weiß).
- Mindesthöhe der Kopfzeile über die CSS-Variable <c>--oo-tnl-header-height</c> (Standard 3rem); in der eingeklappten Ansicht ist sie genau so hoch.


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.