← Toda a documentação

editor.getEditable(bFocus)

Retorna o elemento raiz editável — o body dentro do iframe do editor, que é quem de fato contém o conteúdo digitado pelo usuário. Use-o quando precisar do próprio elemento contêiner: para ler os filhos dele, medi-lo ou limitar uma consulta apenas ao conteúdo editado.

Sintaxe

editor.getEditable(bFocus)

Parâmetros

bFocus — booleano opcional. Quando true, o editor recebe o foco antes de o elemento ser retornado. Omita-o (ou passe um valor falsy) para obter o elemento sem mudar o foco.

Retorno

O elemento body editável.

Observações de comportamento

  • Elemento, não documento. Este método retorna o elemento body; getDocument() retorna o Document que o contém. Os dois ficam dentro do iframe de edição.
  • O foco opcional é uma conveniência. Passar true evita uma chamada separada a focus() quando você está prestes a posicionar uma seleção ou começar a editar.
  • Consulte a partir dele para manter o escopo. Um querySelector no elemento retornado só enxerga o conteúdo editado, nunca a interface da página em volta.

Exemplo de uso

Leia o primeiro parágrafo do conteúdo editado:

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

Dê foco ao editor e obtenha o elemento editável em uma única chamada antes de definir uma seleção:

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

Relacionados