← Toda la documentación

editor.getEditable(bFocus)

Devuelve el elemento raíz editable: el body dentro del iframe del editor que contiene realmente el contenido en el que escribe el usuario. Recurre a él cuando necesites el propio elemento contenedor: para leer sus hijos, medirlo o limitar una consulta solo al contenido editado.

Sintaxis

editor.getEditable(bFocus)

Parámetros

bFocus: booleano opcional. Con true, el editor recibe el foco antes de devolver el elemento. Omítelo (o pasa un valor falsy) para obtener el elemento sin cambiar el foco.

Valor devuelto

El elemento body editable.

Notas de comportamiento

  • Elemento, no documento. Este método devuelve el elemento body; getDocument() devuelve el Document que lo rodea. Ambos están dentro del iframe de edición.
  • El foco opcional es una comodidad. Pasar true te ahorra una llamada aparte a focus() cuando vas a colocar una selección o empezar a editar.
  • Haz las consultas sobre él para no salirte del contenido. Un querySelector sobre el elemento devuelto solo ve el contenido editado, nunca la interfaz de la página que lo rodea.

Ejemplo de uso

Lee el primer párrafo del contenido editado:

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

Da el foco al editor y obtén el elemento editable en una sola llamada antes de establecer una selección:

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

Relacionado