Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Document : méthode caretRangeFromPoint()

Non standard: Cette fonctionnalité n'est pas standardisée. Nous déconseillons d'utiliser des fonctionnalités non standard en production, car leur prise en charge par les navigateurs est limitée, et elles peuvent être modifiées ou supprimées. Toutefois, elles peuvent constituer une alternative appropriée dans certains cas où aucune option standard n'existe.

La méthode caretRangeFromPoint() de l'interface Document retourne un objet Range pour le fragment de document situé aux coordonnées définies.

Cette méthode est l'implémentation propriétaire de WebKit de la méthode Document.caretPositionFromPoint.

Syntaxe

js
caretRangeFromPoint(x, y)

Paramètres

x

Une position horizontale dans la zone d'affichage (viewport en anglais) actuelle.

y

Une position verticale dans la zone d'affichage (viewport en anglais) actuelle.

Valeur de retour

La valeur de retour peut être :

  • Un objet Range.
  • Ou null, si x ou y sont négatifs, situés en dehors de la zone d'affichage ou s'il n'y a pas de nœud texte correspondant.

Exemples

Consultez la page Document.caretPositionFromPoint pour voir un exemple interactif de cette méthode.

Spécifications

Ne fait pas partie d'une spécification.

Compatibilité des navigateurs