RichTextView
Zeigt HTML aus dem RichTextEditor sicher an: bereinigt (keine Skripte, Event-Handler, javascript:-Links, iframes, Formulare),
gestaltet wie im Editor, mit Syntaxfarben, Kopierknöpfen, Mermaid, Bild-Lightbox und abhakbaren Todos.
Serverseitig dieselben Regeln über OoRichText.
Anzeige mit abhakbaren Todos
OnTodoToggled gesetzt: ein Klick auf die Checkbox meldet TodoId und Erledigt;
der Handler speichert mit OoRichText.TodoSetzen. Fortschritt über OoRichText.Fortschritt.
Fortschritt: 1 / 4 (25 %) · Zuletzt: –
Upload im Editor
Bilder sollen hochgeladen statt eingebettet werden – siehe GitHub und UploadUrl.
- Parameter
UploadUrlergänzen - Demo-Endpunkt anlegen
- Doku generieren
- SKILL.md prüfen
Ohne UploadUrl bleibt alles wie bisher.
| Feld | Typ |
|---|---|
| url | string |
| istBild | bool |
var html = OoRichText.Bereinigen(eingabe);
await SpeichernAsync(html);graph LR Editor --> Upload --> Anzeige
- Erstens
- Zweitens
Nur Anzeige
Ohne
OnTodoToggled sind die Checkboxen nicht anklickbar. Size="@OoSize.Sm", Links ohne neuen Tab (OpenLinksInNewTab="false").
Upload im Editor
Bilder sollen hochgeladen statt eingebettet werden – siehe GitHub und UploadUrl.
- Parameter
UploadUrlergänzen - Demo-Endpunkt anlegen
- Doku generieren
- SKILL.md prüfen
Ohne UploadUrl bleibt alles wie bisher.
| Feld | Typ |
|---|---|
| url | string |
| istBild | bool |
var html = OoRichText.Bereinigen(eingabe);
await SpeichernAsync(html);graph LR Editor --> Upload --> Anzeige
- Erstens
- Zweitens
Bereinigung
Skript,
onerror, javascript:-Link, iframe und Formular werden entfernt; Text, Klassen und Todo-Attribute bleiben.
Eingabe
<p onclick="alert(1)" class="hinweis">Text mit <strong>Formatierung</strong></p><script>alert('x')</script><img src="x" onerror="alert(2)"><a href="javascript:alert(3)">Böser Link</a> <a href="https://example.com" target="_blank">Guter Link</a><iframe src="https://example.com"></iframe><form action="/x"><input name="a"><button>Senden</button></form><ul class="todo-list"><li data-todo-id="t_9" data-checked="true" data-boese="1">Todo bleibt</li></ul>
OoRichText.Bereinigen
<p class="hinweis">Text mit <strong>Formatierung</strong></p><img src="x"><a>Böser Link</a> <a href="https://example.com" target="_blank" rel="noopener noreferrer">Guter Link</a><ul class="todo-list"><li data-todo-id="t_9" data-checked="true">Todo bleibt</li></ul>Anzeige
Editor und Anzeige
Toolbar="ToolbarEnum.Ausfuehrlich" mit UploadUrl: Bilder und Dateien (Einfügen, Ziehen, Büroklammer-Button) werden hochgeladen.
Darunter die Anzeige und OoRichText.AlsText.
Hier schreiben, Bilder einfügen oder Dateien hineinziehen …
- Erstes Todo
Hier schreiben, Bilder einfügen oder Dateien hineinziehen … Erstes Todo
SKILL.md – Richtextview
---
name: RichTextView
description: Onesown Blazor Komponente RichTextView (Viewer). Verwende diesen Skill wenn du die RichTextView-Komponente verwenden, konfigurieren oder debuggen moechtest.
---
# RichTextView
**Namespace:** `Onesown.Blazor.Components`
**Kategorie:** Viewer
**Basisklasse:** `OoComponentBase`
Zeigt HTML aus dem RichTextEditor (Jodit) sicher an: bereinigt es standardmäßig (keine Skripte, Event-Handler, javascript:-Links, iframes, Formulare) und gestaltet es wie im Editor – Tabellen, Bilder, Links, Code-Blöcke mit Syntaxfarben und Kopierknopf, Mermaid-Diagramme, Todo-Listen (optional abhakbar) und eine Lightbox für Bilder.
**Live-Demo:** https://components.schini.com/demo/richtextview
## Parameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| ``Html`` | ``string`` | | Das anzuzeigende HTML, typischerweise der Wert eines RichTextEditors. Null oder leer zeigt nichts an. |
| ``Sanitize`` | ``bool`` | ``true`` | Bereinigt das HTML vor der Anzeige mit OoRichText.Bereinigen: entfernt script, iframe, object, Formulare, Event-Handler-Attribute und javascript:-Adressen; Formatierung, Tabellen, Bilder, Links, Code, Todo-Listen, Mermaid und class bleiben. Standard: true. |
| ``OnTodoToggled`` | ``EventCallback<RichTextTodoToggledArgs>`` | | Wird ausgelöst, wenn der Nutzer die Checkbox eines Todo-Eintrags (li in einer ul.todo-list) anklickt; liefert TodoId und den neuen Zustand Erledigt. Nur wenn gesetzt, sind die Checkboxen anklickbar. Der Haken wechselt sofort im Browser; die Anwendung speichert mit OoRichText.TodoSetzen. |
| ``OpenLinksInNewTab`` | ``bool`` | ``true`` | Links (außer Sprungmarken mit #) öffnen in einem neuen Tab mit rel="noopener noreferrer". Standard: true. |
| ``EnableImageLightbox`` | ``bool`` | ``true`` | Ein Klick auf ein Bild öffnet es groß; mit den Pfeilen geht es zu den übrigen Bildern. Bilder in Links bleiben Links. Standard: true. |
## 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)
- Einfachster Fall: <RichTextView Html="@issue.Beschreibung" /> – bereinigt, Links im neuen Tab, Bilder per Klick groß
- Todos abhakbar: OnTodoToggled="TodoGeaendert" setzen; im Handler html = OoRichText.TodoSetzen(html, args.TodoId, args.Erledigt) und speichern. Ohne OnTodoToggled sind die Checkboxen reine Anzeige
- Nur der Checkbox-Bereich links am Eintrag reagiert auf Klicks, Text und Links im Eintrag bleiben normal bedienbar
- Sanitize="false" nur für HTML, das schon beim Speichern mit OoRichText.Bereinigen(html) bereinigt wurde
- Serverseitig dieselben Regeln: OoRichText.Bereinigen vor dem Speichern, OoRichText.AlsText für Suche/Vorschau, OoRichText.Fortschritt für „3/5 erledigt“
- Schriftgröße über Size, etwa Size="@OoSize.Sm"; ohne Size erbt der Text die Schriftgröße der Umgebung
- Gestaltung über die CSS-Klassen oo-richtext-view (Root) und oo-richtext (Inhalt), etwa .oo-richtext-view .oo-richtext img { … }