← Toute la documentation

editor.getDocument()

Renvoie l’objet Document de la zone d’édition de l’éditeur. Le contenu que vous modifiez se trouve dans une iframe : il s’agit donc du document de cette iframe, et non du document de la page extérieure. Utilisez-la chaque fois que vous devez effectuer des opérations DOM (requêtes, plages, création de nœuds) sur le contenu édité lui-même.

Syntaxe

editor.getDocument()

Paramètres

Aucun.

Valeur renvoyée

Le Document de l’iframe d’édition.

Remarques sur le comportement

  • C’est le document de l’iframe, pas celui de la page. L’éditeur affiche son contenu dans une iframe isolée. Un document.querySelector sur la page extérieure ne trouvera pas les nœuds situés dans l’éditeur — interrogez plutôt editor.getDocument().
  • Créez les nœuds à partir de ce document. Les éléments et les plages que vous comptez insérer dans l’éditeur doivent être créés avec editor.getDocument().createElement(...) / createRange() pour appartenir au bon document.
  • Associez-la à getEditable() lorsque vous voulez l’élément body modifiable plutôt que tout le document.

Exemple d’utilisation

Compter les images du contenu édité (dans l’éditeur, pas dans la page) :

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

Construire un nœud à partir du document de l’éditeur avant de l’insérer :

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

Voir aussi