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 précède le concept de shadow DOM et retourne des résultats imprévisibles et spécifiques à l'implémentation dans un document contenant des objets ShadowRoot.

Utilisez caretPositionFromPoint() à la place sur les navigateurs compatibles, car il s'agit d'une méthode standard qui peut retourner la position du caret à l'intérieur des instances de ShadowRoot, à condition que les shadow roots pertinents soient passés dans son paramètre options.

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

Voir aussi