← Toute la documentation

editor.getSelectionElement()

Renvoie l’élément qui contient la sélection courante. Selon ce qui est sélectionné, il s’agit du contrôle sélectionné, de la cellule de tableau où se trouve le curseur, ou de l’élément qui englobe une plage surlignée. Utilisez-la pour savoir « où se trouve l’utilisateur en ce moment » — par exemple pour n’activer les contrôles de tableau qu’à l’intérieur d’une cellule.

Syntaxe

editor.getSelectionElement()

Paramètres

Aucun.

Valeur renvoyée

L’élément englobant, ou null lorsque la sélection n’a pas de conteneur unique pertinent (par exemple une sélection vide sans ancre).

Remarques sur le comportement

  • Un contrôle sélectionné l’emporte. Si un contrôle (comme une image) est sélectionné, il est renvoyé directement — le même élément que celui que vous obtiendriez avec getSelectedControl().
  • Un curseur dans une cellule de tableau renvoie cette cellule. Lorsque la sélection est réduite à l’intérieur d’un TD ou d’un TH, cette cellule est renvoyée — pratique pour activer des actions propres aux cellules.
  • Une plage renvoie son élément englobant. Pour une plage surlignée, getSelectionElement() remonte jusqu’à l’élément qui contient les deux extrémités de la sélection.

Exemple d’utilisation

Savoir si le curseur se trouve dans une cellule de tableau :

var editor1 = new RichTextEditor("#div_editor1");
var el = editor1.getSelectionElement();
var inCell = el && (el.closest("td") || el.closest("th"));

Lire le lien le plus proche de la sélection courante :

var el = editor1.getSelectionElement();
var link = el ? el.closest("a[href]") : null;
if (link) console.log("Editing link:", link.href);

Voir aussi