← Gesamte Dokumentation

editor.getEditable(bFocus)

Gibt das bearbeitbare Wurzelelement zurück – das body im iframe des Editors, das den Inhalt enthält, in den der Benutzer tippt. Greifen Sie darauf zurück, wenn Sie das Container-Element selbst brauchen: um seine Kindelemente zu lesen, es auszumessen oder eine Abfrage auf den bearbeiteten Inhalt zu beschränken.

Syntax

editor.getEditable(bFocus)

Parameter

bFocus – optionaler boolescher Wert. Bei true erhält der Editor den Fokus, bevor das Element zurückgegeben wird. Lassen Sie ihn weg (oder übergeben Sie einen falsy-Wert), um das Element zu erhalten, ohne den Fokus zu ändern.

Rückgabewert

Das bearbeitbare body-Element.

Hinweise zum Verhalten

  • Element, nicht Dokument. Diese Methode gibt das body-Element zurück; getDocument() gibt das umgebende Document zurück. Beide liegen im Bearbeitungs-iframe.
  • Der optionale Fokus ist eine Abkürzung. Die Übergabe von true erspart einen separaten Aufruf von focus(), wenn Sie gleich eine Auswahl setzen oder mit der Bearbeitung beginnen wollen.
  • Abfragen darauf bleiben eingegrenzt. Ein querySelector auf dem zurückgegebenen Element sieht immer nur den bearbeiteten Inhalt, nie die Oberfläche der umgebenden Seite.

Anwendungsbeispiel

Den ersten Absatz des bearbeiteten Inhalts lesen:

var editor1 = new RichTextEditor("#div_editor1");
var body = editor1.getEditable();
var firstPara = body.querySelector("p");

Den Editor fokussieren und das bearbeitbare Element in einem Aufruf abrufen, bevor eine Auswahl gesetzt wird:

var body = editor1.getEditable(true);   // focuses, then returns the element

Siehe auch