← Gesamte Dokumentation

editor.getSelectedText()

Gibt den Inhalt der aktuellen Auswahl als reinen Text zurück – den Text, den der Benutzer markiert hat, ohne Formatierung. Verwenden Sie die Methode für Wortzählungen, Nachschlagefunktionen, Aktionen wie „im Web nach diesem Ausdruck suchen“ oder alles, was den ausgewählten Text statt seines Markups braucht.

Syntax

editor.getSelectedText()

Parameter

Keine.

Rückgabewert

Der ausgewählte Text als String oder null, wenn die Auswahl zusammengefallen ist (ein Cursor ohne markierten Text).

Hinweise zum Verhalten

  • Eine zusammengefallene Auswahl ergibt null. Bei einem bloßen Cursor ohne markierten Text gibt getSelectedText() null zurück – prüfen Sie das, bevor Sie das Ergebnis verwenden.
  • Reiner Text, kein HTML. Das Ergebnis ist nur der Text; verwenden Sie getHTMLCode() oder den Bereich der Auswahl, wenn Sie den Inhalt mit Markup brauchen.
  • Spiegelt die aktuelle Auswahl wider, lesen Sie den Wert also in dem Moment, in dem Sie ihn brauchen (zum Beispiel im Klick-Handler einer Symbolleisten-Schaltfläche).

Anwendungsbeispiel

Mit dem markierten Text arbeiten und dabei eine leere Auswahl abfangen:

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

Eine Live-Zeichenzählung der aktuellen Auswahl anzeigen:

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

Siehe auch