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
caretRangeFromPoint(x, y)
Paramètres
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
- La méthode
Document.caretPositionFromPoint()