← Toute la documentation

editor.getSelectedText()

Renvoie le contenu en texte brut de la sélection courante — le texte que l’utilisateur a surligné, sans mise en forme. Utilisez-la pour un comptage de mots, une recherche, une action du type « rechercher cette expression sur le web », ou tout ce qui a besoin du texte sélectionné plutôt que de son balisage.

Syntaxe

editor.getSelectedText()

Paramètres

Aucun.

Valeur renvoyée

Le texte sélectionné sous forme de chaîne, ou null quand la sélection est réduite (un curseur sans texte surligné).

Remarques sur le comportement

  • Une sélection réduite renvoie null. Avec un simple curseur et aucun texte surligné, getSelectedText() renvoie null — vérifiez ce cas avant d’utiliser le résultat.
  • Du texte brut, pas du HTML. Le résultat ne contient que le texte ; utilisez getHTMLCode() ou la plage de sélection si vous avez besoin du contenu balisé.
  • Elle reflète la sélection en direct, lisez-la donc au moment où vous en avez besoin (par exemple dans le gestionnaire de clic d’un bouton de barre d’outils).

Exemple d’utilisation

Agir sur le texte surligné, en se protégeant d’une sélection vide :

var editor1 = new RichTextEditor("#div_editor1");
var text = editor1.getSelectedText();
if (text) {
    window.open("https://www.google.com/search?q=" + encodeURIComponent(text));
}

Afficher en direct le nombre de caractères de la sélection courante :

var text = editor1.getSelectedText() || "";
console.log(text.length + " characters selected");

Voir aussi