ReconnectDialog
Deutscher Hinweis, solange die Verbindung einer Blazor-Server-App zum Server weg ist: Verbinden mit Spinner, Countdown, gescheitert mit „Erneut versuchen“, angehalten mit „Fortsetzen“. Einmal statisch in App.razor einbinden – das Script kommt mit OnesownBlazorComponentsScripts. Kennt der Server die Sitzung nicht mehr, lädt die Seite neu. Diese Demo-App nutzt ihn selbst.
Zustände
Vorschau mit
PreviewState: inline statt modal, ohne die IDs, über die Blazor den echten Dialog findet. In der App steht <ReconnectDialog /> ohne Parameter in App.razor.
Zustand: Show
Eigene Texte
Eigene Texte, etwa für eine englische App;
{0} in RetryingText wird zum Countdown in Sekunden.
SKILL.md – Reconnectdialog
---
name: ReconnectDialog
description: Onesown Blazor Komponente ReconnectDialog (Feedback). Verwende diesen Skill wenn du die ReconnectDialog-Komponente verwenden, konfigurieren oder debuggen moechtest.
---
# ReconnectDialog
**Namespace:** `Onesown.Blazor.Components`
**Kategorie:** Feedback
**Basisklasse:** `OoComponentBase`
Deutscher Hinweis im Library-Stil, solange die Verbindung einer Blazor-Server-App zum Server weg ist – ersetzt die englische Standardanzeige von Blazor. Rendert den Dialog #components-reconnect-modal, den Blazor selbst findet und dessen Zustand es als Klasse components-reconnect-* setzt; je Zustand ist nur die passende Zeile sichtbar (Verbinden mit Spinner, Countdown, gescheitert mit „Erneut versuchen“, angehalten mit „Fortsetzen“).
**Live-Demo:** https://components.schini.com/demo/reconnectdialog
## Parameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``ReconnectingText`` | ``string`` | ``"Die Verbindung zum Server ist unterbrochen. Verbinde neu …"`` | Text beim ersten Verbindungsversuch. Standard: „Die Verbindung zum Server ist unterbrochen. Verbinde neu …“ |
| ``RetryingText`` | ``string`` | ``"Neu verbinden hat nicht geklappt. Nächster Versuch in {0} Sekunden."`` | Text, wenn ein Versuch gescheitert ist; {0} wird zum Countdown in Sekunden. Standard: „Neu verbinden hat nicht geklappt. Nächster Versuch in {0} Sekunden.“ |
| ``FailedText`` | ``string`` | ``"Keine Verbindung zum Server. Bitte erneut versuchen oder die Seite neu laden."`` | Text, wenn alle Versuche gescheitert sind. Standard: „Keine Verbindung zum Server. Bitte erneut versuchen oder die Seite neu laden.“ |
| ``PausedText`` | ``string`` | ``"Der Server hat die Sitzung angehalten."`` | Text, wenn der Server die Sitzung angehalten hat. Standard: „Der Server hat die Sitzung angehalten.“ |
| ``ResumeFailedText`` | ``string`` | ``"Die Sitzung ließ sich nicht fortsetzen. Bitte erneut versuchen oder die Seite neu laden."`` | Text, wenn sich die angehaltene Sitzung nicht fortsetzen ließ. Standard: „Die Sitzung ließ sich nicht fortsetzen. Bitte erneut versuchen oder die Seite neu laden.“ |
| ``RetryText`` | ``string`` | ``"Erneut versuchen"`` | Beschriftung des Knopfs nach gescheiterten Versuchen. Standard: „Erneut versuchen“. |
| ``ResumeText`` | ``string`` | ``"Fortsetzen"`` | Beschriftung des Knopfs bei angehaltener Sitzung. Standard: „Fortsetzen“. |
| ``ReloadOnRejected`` | ``bool`` | ``true`` | Kennt der Server die Sitzung nicht mehr (Zustand „rejected“, etwa nach einem Neustart), die Seite neu laden. Standard: true. |
| ``RetryWhenVisible`` | ``bool`` | ``true`` | Nach „gescheitert“ erneut verbinden, sobald der Tab wieder sichtbar wird. Standard: true. |
| ``ShowDelay`` | ``int`` | ``2000`` | Millisekunden, die eine Unterbrechung dauern muss, bevor „Verbinde neu …“ erscheint; ist die Verbindung vorher wieder da, sieht man nichts. Gescheitert und angehalten erscheinen sofort. Standard: 2000. |
| ``ChildContent`` | ``RenderFragment`` | | Eigener Inhalt statt der Standardtexte (selten). Elemente mit den Klassen components-reconnect-first-attempt-visible, -repeated-attempt-visible, -failed-visible, components-pause-visible und components-resume-failed-visible erscheinen je Zustand; Knöpfe mit data-oo-reconnect-action="retry" bzw. "resume" verbinden neu bzw. setzen fort. |
| ``PreviewState`` | ``OoReconnectState?`` | | Nur zur Vorschau, etwa in Doku- und Demo-Seiten: zeigt den Dialog inline im angegebenen Zustand, ohne die IDs, über die Blazor ihn findet, und ohne Funktion der Knöpfe. Standard: null (echter Dialog). |
## 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)
- Einbindung einmalig in App.razor, statisch (ohne @rendermode) im body vor den Scripts: <ReconnectDialog />
- Das Script reconnect-dialog.js kommt mit OnesownBlazorComponentsScripts; eine eigene ReconnectModal.razor.js der .NET-Vorlage entfällt
- Verbinden erscheint erst nach ShowDelay (2 s) und nie, während die Seite verlassen bzw. neu geladen wird – kurze Wackler und F5 blitzen nicht auf
- Die Knöpfe sind reines HTML (die Verbindung ist ja weg) und rufen Blazor.reconnect() bzw. Blazor.resumeCircuit() auf
- Kennt der Server die Sitzung nicht mehr (etwa nach einem Neustart), lädt die Seite neu (ReloadOnRejected)
- Nach „gescheitert“ versucht der Dialog es erneut, sobald der Tab wieder sichtbar wird (RetryWhenVisible)
- Texte über ReconnectingText, RetryingText ({0} = Sekunden bis zum nächsten Versuch), FailedText, PausedText, ResumeFailedText, RetryText, ResumeText
- Vorschau ohne echte Trennung, etwa in einer Doku-Seite: PreviewState="OoReconnectState.Failed" (inline, ohne Blazor-IDs)
- Zusammen mit ErrorBar für unbehandelte Fehler