← Toute la documentation

editor.getSelectedControl()

Renvoie l’élément de contrôle actuellement sélectionné — en général une image sur laquelle l’utilisateur a cliqué, affichée avec des poignées de redimensionnement. Elle renvoie null lorsque la sélection est du texte ordinaire ou un curseur. Utilisez-la pour construire des actions contextuelles sur un objet sélectionné, comme un bouton « modifier l’image » ou « définir le texte alternatif ».

Syntaxe

editor.getSelectedControl()

Paramètres

Aucun.

Valeur renvoyée

L’élément de contrôle sélectionné, ou null si aucun contrôle n’est sélectionné.

Remarques sur le comportement

  • La sélection d’un contrôle est distincte de la sélection de texte. Cliquer sur une image la sélectionne en tant que contrôle ; faire glisser la souris sur des mots crée une plage de texte. Seul le premier cas fait renvoyer un élément à getSelectedControl().
  • Renvoie null pour un curseur ou une plage de texte. Vérifiez null avant d’utiliser le résultat.
  • Elle pilote les comportements propres aux objets. L’éditeur lui-même vérifie le contrôle sélectionné dans des opérations comme delete(), qui supprime l’image sélectionnée plutôt que du texte.

Exemple d’utilisation

N’activer une action « modifier l’image » que lorsqu’une image est sélectionnée :

var editor1 = new RichTextEditor("#div_editor1");
var control = editor1.getSelectedControl();
if (control && control.tagName === "IMG") {
    openImageOptions(control);   // e.g. resize, alt text, replace
}

Lire l’URL source de l’image actuellement sélectionnée :

var control = editor1.getSelectedControl();
var src = control && control.tagName === "IMG" ? control.src : null;

Voir aussi