← Toute la documentation

editor.getSelection()

Renvoie l’objet de sélection actif de l’éditeur — la sélection dans la zone d’édition, et non le window.getSelection() de la page extérieure. Utilisez-la pour examiner ce qui est sélectionné, lire des plages ou piloter une logique de sélection de bas niveau dans des commandes personnalisées.

Syntaxe

editor.getSelection()

Paramètres

Aucun.

Valeur renvoyée

L’objet de sélection de l’éditeur.

Remarques sur le comportement

  • Limitée à l’iframe d’édition. Il s’agit de la sélection dans le contenu de l’éditeur : ses plages pointent donc vers des nœuds situés dans editor.getDocument() — et non dans la page environnante.
  • C’est la sélection en direct. Lisez-la au moment où vous en avez besoin ; elle reflète la position actuelle du curseur ou du surlignage.
  • Pour les besoins courants, il existe des fonctions de plus haut niveau. Utilisez getSelectedText() pour le texte et getSelectionElement() pour l’élément englobant, plutôt que de parcourir la sélection à la main.

Exemple d’utilisation

Vérifier si quelque chose est sélectionné :

var editor1 = new RichTextEditor("#div_editor1");
var sel = editor1.getSelection();
if (sel && !sel.isCollapsed) {
    // there is a highlighted range to act on
}

Lire la plage courante à partir de la sélection :

var sel = editor1.getSelection();
if (sel && sel.rangeCount) {
    var range = sel.getRangeAt(0);
    console.log(range.toString());
}

Voir aussi