Dialoge & Overlays
Alle Dialog-Varianten: mit/ohne Header, mit/ohne Close-Button, fixer Breite und eingebettetem Formular. Die Standard-Fußzeile (ConfirmText, OnConfirm) erspart den Buttons-Block. Außerdem DialogService für programmatischen Aufruf ohne Markup, auch für Ein-Feld-Abfragen per PromptAsync.
Standard (auto-Breite)
Header + Close
Kein Close
Kein Header
Standard-Fußzeile
ConfirmText erzeugt die Fußzeile ohne eigenen Buttons-Block: Abbrechen schließt, Bestätigen ruft OnConfirm.
Das X schließt über @bind-Show auch ohne OnClose.
Ergebnis: –
Mit Submit-Formular
Submit + Header
Fixe Breite (700px)
700 px
CloseOnBackdropClick
Overlay-Verhalten
DialogService
Programmatischer Aufruf via
DialogService. <DialogHost /> muss einmalig im Layout eingebunden sein.
ConfirmAsync
Ergebnis: –
AlertAsync
WirklichLoeschenAsync
Ergebnis: –
PromptAsync
Ergebnis: –
OpenAsync<TComponent>
Ergebnis: –
Erweiterbarkeit
DialogService ist ableitbar. Im Consuming-Projekt einfach eine eigene Klasse erstellen,
bestehende Methoden überschreiben oder neue hinzufügen – DialogHost muss nicht angepasst werden.
class & style
class
style
SKILL.md – Dialog
---
name: Dialog
description: Onesown Blazor Komponente Dialog (Feedback). Verwende diesen Skill wenn du die Dialog-Komponente verwenden, konfigurieren oder debuggen moechtest.
---
# Dialog
**Namespace:** `Onesown.Blazor.Components`
**Kategorie:** Feedback
**Basisklasse:** `IDisposable`
Modaler Dialog mit konfigurierbarem Header, Inhalt und Footer-Buttons. Unterstützt Two-Way-Binding für die Sichtbarkeit (@bind-Show), optionalen Close-X-Button, Formular-Validierung via OnValidSubmit und frei wählbare Breite.
**Live-Demo:** https://components.schini.com/demo/dialog
## Parameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Show`` | ``bool`` | ``false`` | Steuert die Sichtbarkeit des Dialogs. true = geöffnet, false = geschlossen. Standard: false. |
| ``ShowChanged`` | ``EventCallback<bool>`` | | Ermöglicht Two-Way-Binding (@bind-Show). Wird automatisch aufgerufen wenn der Dialog sich selbst schließt. |
| ``Header`` | ``RenderFragment`` | | Beliebiges Markup im Header-Bereich. Hat Vorrang vor HeaderText, wenn beides gesetzt ist. |
| ``HeaderText`` | ``string`` | ``""`` | Titeltext im Header. Wird nur angezeigt wenn kein Header-RenderFragment gesetzt ist. |
| ``Content`` | ``RenderFragment`` | | Hauptinhalt des Dialogs als beliebiges Markup. |
| ``Buttons`` | ``RenderFragment`` | | Footer-Bereich des Dialogs, typischerweise mit Aktions-Buttons (Speichern, Abbrechen, …). Hat Vorrang vor der Standard-Fußzeile aus ConfirmText. |
| ``ConfirmText`` | ``string`` | | Text des Bestätigen-Knopfs. Gesetzt (und Buttons leer) erzeugt der Dialog die Standard-Fußzeile: Abbrechen und Bestätigen rechtsbündig. Standard: null (keine Fußzeile). |
| ``ConfirmIcon`` | ``string`` | | Material-Icon des Bestätigen-Knopfs, z. B. "save", "add" oder "delete". Standard: null. |
| ``ConfirmStyle`` | ``OoButtonStyle`` | ``OoColorPalette.Primary`` | Farbe des Bestätigen-Knopfs, z. B. OoColorPalette.Danger für Löschen. Standard: OoColorPalette.Primary. |
| ``OnConfirm`` | ``EventCallback`` | | Wird beim Klick auf den Bestätigen-Knopf ausgelöst (bei ConfirmOnEnter auch per Enter). Schließt den Dialog nicht selbst – das erledigt der Handler (z. B. _offen = false nach erfolgreichem Speichern). |
| ``ConfirmBusy`` | ``bool`` | | Zeigt den Spinner am Bestätigen-Knopf und sperrt beide Knöpfe der Standard-Fußzeile, etwa während gespeichert wird. Standard: false. |
| ``ConfirmDisabled`` | ``bool`` | | Sperrt den Bestätigen-Knopf, etwa solange Pflichtangaben fehlen. Standard: false. |
| ``ConfirmOnEnter`` | ``bool`` | | Macht den Bestätigen-Knopf zum Submit-Knopf des Dialog-Formulars: Enter in einem einzeiligen Eingabefeld löst OnConfirm aus (zusätzlich zu OnValidSubmit, falls gesetzt). Nicht einschalten, wenn Eingaben im Inhalt Enter selbst brauchen (z. B. Auswahllisten). Standard: false. |
| ``CancelText`` | ``string`` | ``"Abbrechen"`` | Text des Abbrechen-Knopfs der Standard-Fußzeile; null blendet ihn aus. Abbrechen schließt wie das X (inkl. Dirty-Flag-Abfrage). Standard: "Abbrechen". |
| ``FooterStart`` | ``RenderFragment`` | | Zusätzlicher Inhalt links in der Standard-Fußzeile, etwa ein Hinweis oder ein Nebenknopf. Standard: null. |
| ``Width`` | ``string`` | ``"auto"`` | Breite des Dialogs. Beliebiger CSS-Wert (z.B. "600px", "80%") oder "auto" für content-basierte Breite. Leer/null = auto |
| ``CloseOnBackdropClick`` | ``bool`` | ``true`` | Schließt den Dialog bei Klick auf den Backdrop. Standard: true. |
| ``ShowHeader`` | ``bool?`` | | Steuert ob der Header-Bereich gerendert wird. Wenn null (Standard): Header erscheint automatisch sobald HeaderText/Header gesetzt ist oder ein Close-X vorhanden ist. Explizit auf false setzen um den Header komplett zu unterdrücken. |
| ``OnClose`` | ``EventCallback`` | | Wird ausgelöst, wenn sich der Dialog schließt (X, Abbrechen, ESC, Backdrop). Für das Schließen selbst nicht nötig – bei @bind-Show setzt der Dialog den Wert selbst auf false. |
| ``ShowClose`` | ``bool`` | ``true`` | Blendet den Close-X-Button aus. Standard: true (sichtbar, auch ohne OnClose). |
| ``OnValidSubmit`` | ``EventCallback<Form>`` | | Wird aufgerufen nachdem das Formular im Dialog erfolgreich validiert wurde. Liefert das Form-Objekt. |
| ``AktiviereDirtyFlag`` | ``bool`` | ``false`` | Aktiviert das Dirty-Flag: Beim Schließen mit ungespeicherten Änderungen erscheint eine Sicherheitsabfrage. Standard: false. |
| ``DirtyFlagTitel`` | ``string`` | ``"Ungespeicherte Änderungen"`` | Titel des Dirty-Confirm-Dialogs. Standard: "Ungespeicherte Änderungen". |
| ``DirtyFlagNachricht`` | ``string`` | ``"Es gibt ungespeicherte Änderungen. Möchten Sie den Dialog wirklich schließen und die Änderungen verwerfen?"`` | Nachrichtentext des Dirty-Confirm-Dialogs. |
| ``DirtyFlagOkText`` | ``string`` | ``"Änderungen verwerfen"`` | Beschriftung des Bestätigen-Buttons im Dirty-Confirm-Dialog. Standard: "Änderungen verwerfen". |
| ``DirtyFlagAbbrechenText`` | ``string`` | ``"Abbrechen"`` | Beschriftung des Abbrechen-Buttons im Dirty-Confirm-Dialog. Standard: "Abbrechen". |
## Hinweise
- Öffnen/Schließen: @bind-Show="_show" für Two-Way-Binding; Show="true" für rein einseitiges Binding
- Schließen per Backdrop: CloseOnBackdropClick="false" verhindert das Schließen bei Klick außerhalb
- Eigener Header: Header-RenderFragment hat Vorrang vor HeaderText; für keinen Header ShowHeader="false" setzen
- Close-X: erscheint standardmäßig und schließt den Dialog selbst (setzt bei @bind-Show den Wert auf false) – OnClose ist dafür nicht nötig, nur für zusätzliche Reaktionen; ShowClose="false" blendet es aus
- Standard-Fußzeile: ConfirmText="Speichern" ConfirmIcon="save" OnConfirm="SpeichernAsync" erzeugt Abbrechen (Neutral.Ghost) und Bestätigen (Primary) ohne eigenen Buttons-Block; ConfirmStyle="OoColorPalette.Danger" für Löschen
- Enter bestätigt: ConfirmOnEnter="true" macht den Bestätigen-Knopf zum Submit-Knopf – Enter in einem einzeiligen Eingabefeld löst OnConfirm aus
- Laufende Aktion: ConfirmBusy="@_speichert" zeigt den Spinner am Bestätigen-Knopf und sperrt Abbrechen
- Ein-Feld-Abfragen ohne Markup: DialogService.PromptAsync("Titel", "Label")
- Formular-Modus: OnValidSubmit empfängt das Form-Objekt nach erfolgreicher Validierung
- Dirty-Flag: AktiviereDirtyFlag="true" warnt beim Schließen bei ungespeicherten Änderungen
- Breite: Width="600px" oder Width="80%" – ohne Angabe passt sich der Dialog dem Inhalt an