← Gesamte Dokumentation

editor.getSelectionElement()

Gibt das Element zurück, das die aktuelle Auswahl enthält. Je nachdem, was ausgewählt ist, ist das das ausgewählte Steuerelement, die Tabellenzelle, in der der Cursor steht, oder das Element, das einen markierten Bereich umschließt. Damit beantworten Sie die Frage „Wo befindet sich der Benutzer gerade?“ – etwa um Tabellenfunktionen nur innerhalb einer Zelle zu aktivieren.

Syntax

editor.getSelectionElement()

Parameter

Keine.

Rückgabewert

Das umschließende Element oder null, wenn die Auswahl keinen sinnvollen einzelnen Container hat (etwa eine leere Auswahl ohne Anker).

Hinweise zum Verhalten

  • Ein ausgewähltes Steuerelement hat Vorrang. Ist ein Steuerelement (etwa ein Bild) ausgewählt, wird es direkt zurückgegeben – dasselbe Element, das Sie von getSelectedControl() erhalten würden.
  • Ein Cursor in einer Tabellenzelle ergibt diese Zelle. Ist die Auswahl innerhalb eines TD oder TH zusammengefallen, wird diese Zelle zurückgegeben – praktisch, um zellbezogene Aktionen zu aktivieren.
  • Ein Bereich ergibt sein umschließendes Element. Bei einem markierten Bereich geht getSelectionElement() nach oben bis zu dem Element, das beide Enden der Auswahl enthält.

Anwendungsbeispiel

Herausfinden, ob der Cursor in einer Tabellenzelle steht:

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

Den nächstgelegenen Link an der aktuellen Auswahl lesen:

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

Siehe auch