SidebarLayout

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 UploadUrl ergänzen
  • Demo-Endpunkt anlegen
  • Doku generieren
    • SKILL.md prüfen
Ohne UploadUrl bleibt alles wie bisher.
FeldTyp
urlstring
istBildbool
var html = OoRichText.Bereinigen(eingabe);
await SpeichernAsync(html);
graph LR
  Editor --> Upload --> Anzeige

Beispielbild


  1. Erstens
  2. 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 UploadUrl ergänzen
  • Demo-Endpunkt anlegen
  • Doku generieren
    • SKILL.md prüfen
Ohne UploadUrl bleibt alles wie bisher.
FeldTyp
urlstring
istBildbool
var html = OoRichText.Bereinigen(eingabe);
await SpeichernAsync(html);
graph LR
  Editor --> Upload --> Anzeige

Beispielbild


  1. Erstens
  2. 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

Text mit Formatierung

Böser Link Guter Link
  • Todo bleibt

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
Als Text:
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: &lt;RichTextView Html="@issue.Beschreibung" /&gt; – 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 { … }


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.