Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Dokument: caretRangeFromPoint() Methode

Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.

Die caretRangeFromPoint()-Methode des Document-Interfaces gibt ein Range-Objekt für das Dokumentfragment unter den angegebenen Koordinaten zurück.

Diese Methode stammt aus der Zeit vor dem Konzept des Shadow DOM und liefert in einem Dokument, das ShadowRoot-Objekte enthält, unvorhersehbare und implementierungsspezifische Ergebnisse.

Verwenden Sie stattdessen caretPositionFromPoint() in unterstützenden Browsern, da es sich um eine standardisierte Methode handelt, die die Caret-Position innerhalb von ShadowRoot-Instanzen zurückgeben kann, vorausgesetzt, die relevanten Shadow-Roots werden im options-Parameter übergeben.

Syntax

js
caretRangeFromPoint(x, y)

Parameter

x

Eine horizontale Position innerhalb des aktuellen Viewports.

y

Eine vertikale Position innerhalb des aktuellen Viewports.

Rückgabewert

Eines der folgenden:

  • Ein Range.
  • null, wenn x oder y negativ sind, außerhalb des Viewports liegen oder kein Texteingabeknoten vorhanden ist.

Beispiele

Besuchen Sie die Seite Document.caretPositionFromPoint(), um ein Live-Beispiel dieser Methode zu sehen.

Spezifikationen

Keine Spezifikation vorhanden.

Browser-Kompatibilität

Siehe auch