SidebarLayout

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

Die Verbindung zum Server ist unterbrochen. Verbinde neu …

Neu verbinden hat nicht geklappt. Nächster Versuch in 5 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.

Eigene Texte

Eigene Texte, etwa für eine englische App; {0} in RetryingText wird zum Countdown in Sekunden.

Die Verbindung zum Server ist unterbrochen. Verbinde neu …

Reconnect failed. Next attempt in 5 seconds.

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.

Die Verbindung zum Server ist unterbrochen. Verbinde neu …

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

Connection lost. Please retry or reload the page.

Der Server hat die Sitzung angehalten.

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

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: &lt;ReconnectDialog /&gt;
- 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


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.