HTML Editor

Über

Das Plugin ergänzt Collections und Globals in Payload CMS 3 um ein `htmlEditorField`. Die Toolbar bietet Textformatierung, Überschriften, Listen, Links, Textausrichtung und Tabellen. Der Wert wird als HTML-String in einem regulären Payload-`textarea`-Feld gespeichert. Wer bereits HTML ausgibt oder Inhalte nicht im Lexical-JSON-Format halten möchte, kann die bestehende Ausgabe unverändert weiterverwenden. Das Plugin wird über `htmlEditorPlugin({ mediaCollection })` registriert, das die Upload-Collection für Bilder festlegt. Jedes Feld kann diese Collection mit der Option `mediaCollection` überschreiben und mit `maxUploadSize` eine Obergrenze in Bytes setzen (Standard: 10 MB). Bildeinfügen, Medienauswahl, Tabellen, Textausrichtung und der HTML-Quelltext-Dialog sind standardmäßig aktiviert. Mit `features.images`, `features.tables`, `features.sourceEditing` oder `features.textAlignment` lassen sich die jeweiligen Toolbar-Elemente und Tiptap-Extensions pro Feld auf `false` setzen. Bild-Uploads laufen über die REST API von Payload mit den Zugangsdaten des angemeldeten Admin-Benutzers und akzeptieren JPEG, PNG, WebP und GIF. Media-Dokumente brauchen mindestens `id` und `url`, `alt`, `filename`, `width`, `height` und `sizes` sind optional. Das Plugin bereinigt das HTML nicht. Das Tiptap-Schema entfernt beim Parsen und Speichern nicht unterstützte Tags und Attribute, die Sanitisierung der Ausgabe bleibt aber Aufgabe der Anwendung, besonders wenn nicht vertrauenswürdige Nutzer Inhalte schreiben. Beim Übernehmen von WordPress- oder CKEditor-Markup kann eine Konvertierung nötig sein, weil nicht unterstützte Tags beim Speichern verloren gehen. Peer-Abhängigkeiten sind Payload ^3.90.2, React 19.2 und Tiptap 3.31. Nach dem Hinzufügen des Feldes muss `npx payload generate:importmap` ausgeführt werden.

Paketinformationen

Paketname

payload-html-editor

Neueste Version

0.1.4

Entpackte Größe

68 kB

Lizenz

MIT

Wöchentliche Downloads

829

Zuletzt veröffentlicht

12. Okt. 2026