SidebarLayout

RichTextEditor

WYSIWYG-Editor auf Jodit-Basis – unterstützt verschiedene Toolbar-Ausprägungen, ReadOnly-Modus, MaxLength, MaxHeight, AfterValueChanged, AutoSaveCallback und Validierung.

Toolbar-Varianten

Alle verfügbaren ToolbarEnum-Werte – von None (kein Werkzeug) bis Max (volle Toolbar). Alle Varianten teilen denselben Bindewert.

None
Textarea
Basic
Simple
Max
Full
Ausfuehrlich
Email
Markdown
Wird vom MarkdownEditor verwendet – dort wird der Wert als Markdown gebunden.
Aktueller HTML-Wert
Länge: 0 Zeichen

Zustände

ReadOnly: Inhalt ist sichtbar, aber nicht editierbar.
Label: Optionaler Label oberhalb des Editors.


ReadOnly
Mit Label

MaxLength & MaxHeight

MaxLength begrenzt die Zeichenanzahl (ohne HTML-Tags) und zeigt bei Überschreitung einen Validierungsfehler.
MaxHeight begrenzt die Höhe des Editors in Pixeln – bei mehr Inhalt erscheint ein Scrollbalken.


MaxLength 100
Zeichenanzahl: 0
MaxHeight 150 px

AfterValueChanged

AfterValueChanged wird nach jeder Inhaltänderung ausgelöst – unabhängig von Validierung.

Änderungen zählen
Änderungen: 0×

AutoSaveCallback

AutoSaveCallback wird nach jeder Wertänderung ausgelöst – standardmäßig nur wenn der Inhalt gültig ist (TriggerAutoSaveCallbackOnlyIfValid).

Nur bei gültigem Wert
Gespeichert: –
Immer speichern
Gespeichert: –

AutoSave-Plugin – Zwischenstände speichern & wiederherstellen

Der 💾-Button in der Toolbar speichert den aktuellen Inhalt manuell im localStorage (max. 10 Einträge, rotierend).
Der Pfeil-Dropdown öffnet die gespeicherten Stände – Klick stellt den Inhalt wieder her.
AutosaveMinutes="2" aktiviert das automatische Speichern im Hintergrund.
AutosaveKey="mein-key" macht den Speicherstand Reload-persistent – ohne diesen Parameter geht die History bei jedem Seiten-Reload verloren.


Manuell (Full-Toolbar)
Mit Autosave (alle 6 Sek.)

Upload statt Base64 (UploadUrl)

Mit UploadUrl gehen eingefügte und gezogene Bilder sowie Dateien über den Büroklammer-Button per POST (multipart, Feld files) an den Demo-Endpunkt /demo-upload; UploadDaten schickt zusätzliche Felder mit. Antwort: [{ "url": "…", "name": "…", "istBild": true }]. Bilder werden als <img>, andere Dateien als Link eingefügt.

Länge: 0 Zeichen (bei Base64 wären es schnell Hunderttausende)

Textbausteine (insertSnippet)

Über den Parameter Snippets wird eine List<SnippetEntry> übergeben. Jeder Eintrag hat ein Label (Anzeigename im Dropdown) und Text (einzufügender HTML-Inhalt). Der Button mit Dropdown-Pfeil erscheint nur, wenn Snippets befüllt ist.

Mit Textbausteinen (Max)

Validierung mit DataAnnotations

Integration in EditContext via Form-Komponente und DataAnnotationsValidator. ShowValidationTooltip zeigt Fehlermeldungen inline.

Zeichenanzahl: 0

class & style

Beliebige HTML-Attribute (class, style, data-*, aria-*) werden an den Editor-Wrapper durchgereicht.

class
style
SKILL.md – Richtexteditor
---
name: RichTextEditor
description: Onesown Blazor Komponente RichTextEditor (Inputs). Verwende diesen Skill wenn du die RichTextEditor-Komponente verwenden, konfigurieren oder debuggen moechtest.
---

# RichTextEditor

**Namespace:** `Onesown.Blazor.Components`  
**Kategorie:** Inputs  
**Basisklasse:** `FormControlBase`  

Rich-Text-Editor auf Basis von Jodit mit konfigurierbarer Toolbar, MaxLength-Anzeige, Readonly-Modus und DataAnnotations-Validierung. Unterstützt verschiedene Toolbar-Presets (Textarea, Simple, Max, Full, Ausfuehrlich …), Todo-Listen, Code-Blöcke und optional das Hochladen von Bildern und Dateien an eine eigene URL statt Base64-Einbettung.

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

## Parameter

| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Value`` | ``string`` |  | Aktuell gebundener HTML-Wert des Editors. |
| ``ValueChanged`` | ``EventCallback<string>`` |  | EventCallback für Two-Way-Binding mit @bind-Value. Wird nach jeder Inhaltsänderung ausgelöst. |
| ``ValueExpression`` | ``Expression<Func<object>>`` |  | LINQ-Expression auf die gebundene Model-Property. Wird benötigt für DataAnnotations-Validierung und Label. |
| ``Required`` | ``bool`` |  | Markiert das Feld als Pflichtfeld für Validierungszwecke. Standard: false. |
| ``Readonly`` | ``bool`` | ``false`` | Setzt den Editor in den Nur-Lesen-Modus: keine Eingabe, Toolbar deaktiviert. Standard: false. |
| ``Toolbar`` | ``ToolbarEnum`` | ``ToolbarEnum.Textarea`` | Toolbar-Preset des Editors. Mögliche Werte: None, Textarea (minimal, Standard), Basic, Simple, Max, Full (alle Funktionen), Ausfuehrlich (für Issues, Kommentare und ähnliche Texte), Email (zum Schreiben von E-Mails, ohne Speichern, Code und Quelltext), Markdown (intern für den MarkdownEditor). |
| ``EnterElement`` | ``string`` |  | HTML-Element das beim Drücken von Enter eingefügt wird (z.B. "p" (Standard), "br", "div"). |
| ``MaxLength`` | ``int`` |  | Maximale Zeichenanzahl (ohne HTML-Tags). 0 = kein Limit. |
| ``MaxHeight`` | ``int?`` |  | Maximale Höhe des Editors in Pixeln. Danach wird der Inhalt scrollbar. 0 = keine Begrenzung. |
| ``JsonData`` | ``string`` |  | JSON-String der an JS-Plugins übergeben wird (z.B. Template-Liste für das Template-Plugin). |
| ``Snippets`` | ``List<SnippetEntry>`` |  | Liste von Textbausteinen für das insertSnippet-Plugin. Jeder Eintrag hat Label (Anzeigename) und Text (einzufügender HTML-Inhalt). |
| ``AutosaveMinutes`` | ``double`` | ``0`` | Autosave-Intervall in Minuten. 0 = deaktiviert. Bei aktiviertem Autosave wird der Inhalt automatisch im localStorage gesichert. |
| ``AutosaveKey`` | ``string`` |  | Stabiler Schlüssel für den localStorage-Autosave (z.B. "notiz-seite1"). Muss pro Editor eindeutig sein. Ohne diesen Parameter wird die zufällige Editor-ID verwendet – Einträge gehen beim Seiten-Reload verloren. |
| ``ToolbarSticky`` | ``bool`` | ``true`` | Aktiviert den klebenden Toolbar, der beim Scrollen am oberen Rand fixiert bleibt. Standard: true. |
| ``ToolbarStickySelector`` | ``string`` |  | CSS-Selektor fixer Header-Elemente (z.B. ".app-kopf" oder mehrere durch Komma: ".app-kopf, .seiten-kopf"), deren Höhen zusammen den Sticky-Offset ergeben. Nur Elemente mit position fixed oder sticky zählen. Optional. |
| ``ToolbarStickyOffset`` | ``int`` | ``0`` | Pixel-Korrektur zum Sticky-Offset (positiv oder negativ). Wird zur Höhe des ToolbarStickySelector addiert. Standard: 0. |
| ``UploadUrl`` | ``string`` |  | Adresse für Datei-Uploads. Wenn gesetzt, werden Bilder (Einfügen, Ziehen, Toolbar) und andere Dateien per HTTP POST (multipart/form-data, Dateien im Feld "files", dazu die Felder aus UploadDaten) an diese URL geschickt statt als Base64 eingebettet, und die Toolbar zeigt einen Button zum Hochladen. Der Server antwortet mit JSON { "url": "/uploads/a.png", "name": "a.png", "istBild": true } oder einer Liste solcher Objekte (eins je Datei); Bilder werden als &lt;img src&gt; eingefügt, andere Dateien als Link mit dem Namen. Fehlt istBild, entscheidet der Dateityp. Die Anfrage geht mit den Cookies der Seite; Antiforgery regelt der Endpunkt selbst (z. B. .DisableAntiforgery() plus eigene Berechtigungsprüfung). Ohne UploadUrl bleibt alles wie bisher (Base64). Ob Upload- oder Base64-Modus gilt und ob der Button erscheint, legt der Wert beim Erstellen des Editors fest; eine später geänderte Adresse (etwa beim Wechsel auf ein anderes Issue) wird bei jedem Upload neu gelesen. |
| ``UploadDaten`` | ``Dictionary<string, string>`` |  | Zusätzliche Formularfelder, die bei jedem Upload mitgeschickt werden (z. B. ["issueId"] = "42"). Werden erst beim Hochladen gelesen, Änderungen gelten also sofort. Nur mit UploadUrl wirksam. |
| ``AenderungenPruefen`` | ``bool`` | ``false`` | Macht ins-/del-Markierungen im Inhalt (z. B. aus HtmlDiffViewer.Diff) prüfbar: farbig dargestellt, Klick zeigt zwei Aktionen, beschriftet nach ihrer Wirkung auf den Text (Einfügen / Nicht einfügen, Löschen / Behalten, „neu“ verwenden / „alt“ behalten). Hovern über eine Aktion zeigt das Ergebnis vorab; Ersetzungen (del + ins) werden gemeinsam hervorgehoben und aufgelöst, reine Formatänderungen (ins class="mod") lassen sich nur annehmen. Text, der in Gelöschtes getippt wird, landet dahinter. Unter der Toolbar liegt eine Zeile mit ‹ Anzahl ›, „Alle übernehmen“ und „Alle verwerfen“; sie klebt mit der Toolbar am oberen Rand. Gilt beim Erstellen des Editors. Standard: false. |
| ``AenderungenSpeichern`` | ``EventCallback`` |  | Nur mit AenderungenPruefen: zeigt am Ende der Änderungszeile einen Speichern-Button, der erst bei 0 offenen Änderungen aktiv ist, und wird bei Klick ausgelöst. Value ist dann bereits aktuell. |

## Geerbte Parameter (FormControlBase)

| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Size`` | ``string`` | ``OoSize.Md`` | 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. |
| ``Id`` | ``string`` | ``Generator.GenerateRandomHtmlTagID()`` | Eindeutige HTML-ID des Input-Elements. Wird automatisch generiert und kann überschrieben werden (z. B. für Labels mit for-Attribut). |
| ``ShowLabel`` | ``bool`` | ``true`` | Blendet das Label über dem Eingabefeld ein oder aus. Standard: true. |
| ``IsFloatingLabel`` | ``bool`` | ``true`` | Aktiviert das schwebende Label (Floating Label), das beim Fokus oder bei Eingabe nach oben animiert. false = festes Label über dem Feld. Standard: true bzw. OoDefaults.Input.IsFloatingLabel. |
| ``Label`` | ``string`` |  | Beschriftung des Eingabefelds. Wird auch als Accessible-Name für Screenreader verwendet. |
| ``Placeholder`` | ``string`` | ``" "`` | Platzhaltertext im leeren Eingabefeld. Standard: Leerzeichen (verhindert Floating-Label-Sprung in Chrome). |
| ``AutoSaveCallback`` | ``EventCallback`` |  | Wird nach jeder Wertänderung ausgelöst und signalisiert der Seite, dass gespeichert werden soll. Kombinierbar mit TriggerAutoSaveCallbackOnlyIfValid. |
| ``TriggerAutoSaveCallbackOnlyIfValid`` | ``bool`` | ``true`` | Steuert ob AutoSaveCallback nur bei gültigem Wert ausgelöst wird. Standard: true. |
| ``AfterValueChanged`` | ``EventCallback`` |  | Wird nach jeder Wertänderung ausgelöst, unabhängig von der Gültigkeit des Werts. Geeignet für Live-Vorschau oder Seiteneffekte. |
| ``ShowValidationTooltip`` | ``bool`` | ``false`` | Zeigt Validierungsmeldungen als Tooltip neben dem Feld statt als Text darunter. Standard: false. |

## Hinweise

- Immer @bind-Value für Two-Way-Binding verwenden
- Für Formular-Validierung ValueExpression="() => _model.Property" setzen
- Komponente muss innerhalb eines &lt;Form&gt;- oder &lt;EditForm&gt;-Containers liegen, damit der EditContext greift
- AutoSaveCallback wird nach jeder gültigen Änderung ausgelöst, wenn TriggerAutoSaveCallbackOnlyIfValid=true (Standard)
- AfterValueChanged wird nach jeder Änderung ausgelöst, unabhängig von der Gültigkeit
- ShowValidationTooltip=true zeigt Validierungsmeldungen als Tooltip statt unter dem Feld
- Eingabefelder (nicht Button/ToggleButton): Defaults für IsFloatingLabel und Size über DefaultsBereich (Input, ersatzweise Size), appweit im Root-Layout; ein Parameter an der Instanz hat Vorrang
- Ändert sich nur ein Cascading-Wert, werden die direkten Parameter nicht erneut gesetzt: Ein Eingabefeld rendert beim Tippen nie den vorigen Wert; inhaltlich gleiche OoDefaults lösen kein Rendern aus
- Toolbar: Toolbar="ToolbarEnum.Textarea" für minimale Toolbar; ToolbarEnum.Simple, Max oder Full für mehr Optionen
- Ausführliche Texte (etwa Issues): Toolbar="ToolbarEnum.Ausfuehrlich" – Überschriften, fett/kursiv/durchgestrichen, Code im Text und als Block, Zitat, Listen, Todo-Liste, Link, Tabelle, Bild/Datei (mit UploadUrl), Trennlinie
- E-Mails schreiben: Toolbar="ToolbarEnum.Email" – Schriftart und -größe, fett/kursiv/unterstrichen/durchgestrichen, Farbe, Ausrichtung, Einzug, Listen, Zitat, Link, Bild, Tabelle, Trennlinie; ohne Speichern, Code und Quelltext
- Upload: UploadUrl="/api/uploads" lädt eingefügte, gezogene und über den Toolbar-Button gewählte Dateien per POST hoch (multipart, Feld "files"); Antwort JSON { "url": "...", "name": "...", "istBild": true } oder eine Liste davon
- Zusatzfelder für den Upload (etwa eine Kontext-Id): UploadDaten="@(new Dictionary&lt;string, string&gt; { ["issueId"] = "42" })"
- Ohne UploadUrl werden Bilder wie bisher verkleinert und als Base64 eingebettet; der Datei-Button fehlt
- Anzeige des HTML: RichTextView; vor dem Speichern auf dem Server OoRichText.Bereinigen(html)
- MaxLength: MaxLength=500 begrenzt die Zeichenanzahl (HTML-Tags werden nicht mitgezählt)
- Readonly: Readonly="true" deaktiviert alle Eingaben und Toolbar-Buttons
- Enter-Element: EnterElement="br" steuert das beim Enter eingefügte HTML-Element (Standard: p)
- Max-Höhe: MaxHeight=400 begrenzt die Editorhöhe in Pixeln und aktiviert das Scrollen
- JSON-Daten: JsonData übergibt strukturierte Daten an JS-Plugins (z.B. Template-Liste)
- Änderungen prüfen: AenderungenPruefen="true" und als Wert HtmlDiffViewer.Diff(alt, neu) – zu jeder ins-/del-Markierung wählt man per Klick Vorschlag oder Original;
- eine Zeile unter der (sticky) Toolbar zeigt die Anzahl, springt mit ‹ › durch die Änderungen und löst alle auf einmal auf,
- AenderungenSpeichern ergänzt dort einen Speichern-Button. Bequemer mit Vergleich und Neuaufbau: HtmlDiffEditor.
- IsFloatingLabel hat hier keine Wirkung, das Label steht immer fest über dem Editor; OoDefaults.Input.IsFloatingLabel wird nicht übernommen


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.