← Gesamte Dokumentation

editor.getSelection()

Gibt das aktuelle Auswahlobjekt des Editors zurück – die Auswahl innerhalb des Bearbeitungsbereichs, nicht window.getSelection() der äußeren Seite. Damit prüfen Sie, was ausgewählt ist, lesen Bereiche oder steuern in eigenen Befehlen eine Auswahllogik auf niedrigerer Ebene.

Syntax

editor.getSelection()

Parameter

Keine.

Rückgabewert

Das Auswahlobjekt des Editors.

Hinweise zum Verhalten

  • Auf das Bearbeitungs-iframe beschränkt. Dies ist die Auswahl innerhalb des Editor-Inhalts, ihre Bereiche zeigen also auf Knoten innerhalb von editor.getDocument() – nicht auf die umgebende Seite.
  • Es ist die aktuelle Auswahl. Lesen Sie sie in dem Moment, in dem Sie sie brauchen; sie spiegelt wider, wo sich Cursor oder Markierung gerade befinden.
  • Für häufige Aufgaben gibt es Hilfsmethoden auf höherer Ebene. Verwenden Sie getSelectedText() für den Text und getSelectionElement() für das umschließende Element, statt die Auswahl von Hand zu durchlaufen.

Anwendungsbeispiel

Prüfen, ob etwas ausgewählt ist:

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

Den aktuellen Bereich aus der Auswahl lesen:

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

Siehe auch