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.
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
Der Pfeil-Dropdown öffnet die gespeicherten Stände – Klick stellt den Inhalt wieder her.
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.
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 <img src> 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 <Form>- oder <EditForm>-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<string, string> { ["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