← Gesamte Dokumentation

editor.getDocument()

Gibt das Document-Objekt des Bearbeitungsbereichs des Editors zurück. Der Inhalt, den Sie bearbeiten, liegt in einem iframe, also ist dies das Dokument dieses iframes – nicht das Dokument der äußeren Seite. Verwenden Sie die Methode immer dann, wenn Sie DOM-Operationen (Abfragen, Bereiche, erzeugte Knoten) auf den bearbeiteten Inhalt selbst anwenden müssen.

Syntax

editor.getDocument()

Parameter

Keine.

Rückgabewert

Das Document des Bearbeitungs-iframes.

Hinweise zum Verhalten

  • Es ist das Dokument des iframes, nicht die Seite. Der Editor stellt seinen Inhalt in einem isolierten iframe dar. Ein document.querySelector auf der äußeren Seite findet keine Knoten im Editor – fragen Sie stattdessen editor.getDocument() ab.
  • Knoten aus diesem Dokument erstellen. Elemente und Bereiche, die Sie in den Editor einfügen wollen, sollten mit editor.getDocument().createElement(...) / createRange() erstellt werden, damit sie zum richtigen Dokument gehören.
  • Mit getEditable() kombinieren, wenn Sie das bearbeitbare body-Element statt des ganzen Dokuments brauchen.

Anwendungsbeispiel

Die Bilder im bearbeiteten Inhalt zählen (beschränkt auf den Editor, nicht die Seite):

var editor1 = new RichTextEditor("#div_editor1");
var doc = editor1.getDocument();
var imageCount = doc.querySelectorAll("img").length;

Einen Knoten aus dem Dokument des Editors erstellen, bevor er eingefügt wird:

var doc = editor1.getDocument();
var hr = doc.createElement("hr");
editor1.insertElement(hr);

Siehe auch