← Toda a documentação

editor.getDocument()

Retorna o objeto Document da área de edição do editor. O conteúdo que você edita fica dentro de um iframe, portanto este é o document desse iframe — não o document da página externa. Use-o sempre que precisar executar operações de DOM (consultas, intervalos, criação de nós) sobre o próprio conteúdo editado.

Sintaxe

editor.getDocument()

Parâmetros

Nenhum.

Retorno

O Document do iframe de edição.

Observações de comportamento

  • É o document do iframe, não o da página. O editor renderiza o conteúdo em um iframe isolado. Um document.querySelector na página externa não encontra nós dentro do editor — consulte editor.getDocument() em vez disso.
  • Crie nós a partir deste document. Elementos e intervalos que você pretende inserir no editor devem ser criados com editor.getDocument().createElement(...) / createRange(), para que pertençam ao document certo.
  • Use junto com getEditable() quando quiser o elemento body editável em vez do document inteiro.

Exemplo de uso

Conte as imagens no conteúdo editado (restrito ao editor, não à página):

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

Crie um nó a partir do document do editor antes de inseri-lo:

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

Relacionados