Drawer
Seitenpanel, das über den Inhalt fährt – wie das Element-Panel bei GitHub Projects. Kopf mit Titel, Aktionen und Schließen-X, scrollender Inhalt, fester Fußbereich. Schließt per Escape oder Klick auf den Hintergrund; Dialoge erscheinen darüber.
Standard (rechts)
Mit
@bind-Show, Aktionen im Kopf (HeaderContent), langem Inhalt und Buttons im FooterContent. Die Rückfrage beim Löschen ist ein Dialog über dem Drawer.
Show: False · Zuletzt: –
Links, schmal, ohne Hintergrund
Position="OoDrawerPosition.Left", Width="22rem", ShowBackdrop="false" – die Seite bleibt bedienbar.
Show: False
Nur über die Buttons schließbar
CloseOnBackdropClick="false" und CloseOnEsc="false".
SKILL.md – Drawer
--- name: Drawer description: Onesown Blazor Komponente Drawer (Feedback). Verwende diesen Skill wenn du die Drawer-Komponente verwenden, konfigurieren oder debuggen moechtest. --- # Drawer **Namespace:** `Onesown.Blazor.Components` **Kategorie:** Feedback **Basisklasse:** `OoComponentBase` Seitenpanel, das von rechts (oder links) über den Inhalt fährt – wie das Element-Panel bei GitHub Projects. Mit Titel, Aktionen im Kopf, Schließen-X, scrollendem Inhalt und festem Fußbereich; schließt per Escape oder Klick auf den Hintergrund. **Live-Demo:** https://components.schini.com/demo/drawer ## Parameter | Parameter | Typ | Standard | Beschreibung | |---|---|---|---| | ``Show`` | ``bool`` | | Steuert die Sichtbarkeit: true = geöffnet. Standard: false. Für Two-Way-Binding @bind-Show verwenden. | | ``ShowChanged`` | ``EventCallback<bool>`` | | Ermöglicht @bind-Show. Wird mit false ausgelöst, wenn der Drawer sich selbst schließt (X, Escape, Hintergrund). | | ``Title`` | ``string`` | | Titel im Kopf des Drawers; zu lange Titel werden mit … abgeschnitten. Dient auch als zugänglicher Name (aria-labelledby). | | ``TitleContent`` | ``RenderFragment`` | | Eigener Inhalt für den Titel statt des reinen Texts aus Title – etwa mit Link. Title bleibt als zugänglicher Name sinnvoll. | | ``HeaderContent`` | ``RenderFragment`` | | Zusätzlicher Inhalt im Kopf rechts neben dem Titel, vor dem Schließen-X – etwa Aktions-Buttons oder ein Kontextmenü. | | ``ChildContent`` | ``RenderFragment`` | | Hauptinhalt des Drawers. Scrollt, wenn er höher als das Fenster ist; Kopf und Fußbereich bleiben stehen. | | ``FooterContent`` | ``RenderFragment`` | | Fußbereich, typischerweise mit Buttons (Speichern, Abbrechen). Bleibt unten sichtbar. Ohne Angabe gibt es keinen Fußbereich. | | ``Width`` | ``string`` | ``"40rem"`` | Breite des Panels als CSS-Wert (z. B. "40rem", "600px", "50vw"). Höchstens 100 % des Fensters; am Handy (bis 48rem) immer volle Breite. Standard: "40rem". | | ``Position`` | ``OoDrawerPosition`` | ``OoDrawerPosition.Right`` | Seite, von der der Drawer hereinfährt: OoDrawerPosition.Right (Standard) oder OoDrawerPosition.Left. | | ``CloseOnBackdropClick`` | ``bool`` | ``true`` | Schließt den Drawer bei Klick auf den abgedunkelten Hintergrund. Wirkt nur mit ShowBackdrop="true". Standard: true. | | ``CloseOnEsc`` | ``bool`` | ``true`` | Schließt den Drawer mit der Escape-Taste – nicht, solange ein Dialog oder die Bild-Lightbox darüber offen ist oder im Drawer eine Auswahlliste bzw. ein Menü aufgeklappt ist (dann schließt Escape zuerst diese). Standard: true. | | ``OnClose`` | ``EventCallback`` | | Wird ausgelöst, nachdem der Drawer sich selbst geschlossen hat (X, Escape, Hintergrund) – nicht, wenn Show von außen auf false gesetzt wird. | | ``ShowBackdrop`` | ``bool`` | ``true`` | Dunkelt den Seiteninhalt hinter dem Drawer ab, sperrt dessen Scrollen und fängt Klicks ab. false lässt die Seite bedienbar. 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) - Öffnen/Schließen: @bind-Show="_offen"; bei einseitigem Show="_offen" das Schließen über OnClose selbst umsetzen - Kopf: Title="Issue #42" und HeaderContent für Aktionen rechts neben dem Titel (vor dem Schließen-X) - Fußbereich: FooterContent mit Buttons bleibt unten sichtbar, nur ChildContent scrollt - Breite: Width="40rem" (Standard), höchstens Fensterbreite; am Handy (bis 48rem) immer volle Breite - Seite: Position="OoDrawerPosition.Left" für ein Panel vom linken Rand - Ohne Abdunkeln und mit bedienbarer Seite dahinter: ShowBackdrop="false"; CloseOnBackdropClick="false" bzw. CloseOnEsc="false" verhindern das jeweilige Schließen - Liegt über Seiteninhalt und Kopfzeilen, aber unter Dialogen (Dialog, DialogService), Kontextmenüs und Toasts – Rückfragen aus dem Drawer erscheinen also darüber - Auch innerhalb von RailLayout, SidebarLayout und TopNavLayout: Solange ein Drawer im Inhalt offen ist, hebt das Layout seinen Inhaltsbereich über Kopfzeile und Leiste – ein SectionContent außerhalb des Layouts ist nicht nötig - Beim Öffnen bekommt das Panel den Fokus, beim Schließen kehrt er zum vorher fokussierten Element zurück