← Toute la documentation

editor.getEditable(bFocus)

Renvoie l’élément racine modifiable — le body de l’iframe de l’éditeur, qui contient réellement le contenu que tape l’utilisateur. Utilisez-la lorsque vous avez besoin de l’élément conteneur lui-même : pour lire ses enfants, le mesurer ou limiter une requête au seul contenu édité.

Syntaxe

editor.getEditable(bFocus)

Paramètres

bFocus — booléen facultatif. Avec true, le focus est placé dans l’éditeur avant que l’élément ne soit renvoyé. Omettez-le (ou transmettez une valeur falsy) pour obtenir l’élément sans changer le focus.

Valeur renvoyée

L’élément body modifiable.

Remarques sur le comportement

  • Un élément, pas un document. Cette méthode renvoie l’élément body ; getDocument() renvoie le Document qui l’entoure. Les deux se trouvent dans l’iframe d’édition.
  • Le focus facultatif est une commodité. Transmettre true évite un appel séparé à focus() lorsque vous êtes sur le point de placer une sélection ou de commencer à éditer.
  • Interrogez cet élément pour rester dans le contenu. Un querySelector sur l’élément renvoyé ne voit jamais que le contenu édité, jamais l’interface de la page environnante.

Exemple d’utilisation

Lire le premier paragraphe du contenu édité :

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

Placer le focus dans l’éditeur et obtenir l’élément modifiable en un seul appel avant de définir une sélection :

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

Voir aussi