CKTIS / JavaScript
MouseEvent.clientY — coordonnée verticale dans la fenêtre d’affichage
MouseEvent.clientY est une propriété en lecture seule qui donne la coordonnée verticale d’un événement de souris par rapport à la fenêtre d’affichage. Elle ne décrit pas une position par rapport à l’élément cible ni à l’écran physique.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
event.clientYMouseEvent.clientY donne la coordonnée verticale à laquelle un événement s’est produit, par rapport à la fenêtre d’affichage associée à cet événement. Vous pouvez la lire avec event.clientY, par exemple lors du traitement de mousemove ou de click. C’est une propriété en lecture seule.
Le repère est la fenêtre d’affichage, et non l’élément ciblé par l’événement. Ne la confondez pas avec clientX, qui décrit la position horizontale, ni avec screenY, dont le repère est l’écran. Vérifiez toujours le repère lorsque vous interprétez des coordonnées.
L’exemple crée un événement synthétique avec clientY: 120 et un autre sans coordonnée explicite. Le constructeur initialise la propriété ; vous ne lui affectez pas de valeur après la création de l’objet. Si clientY est omis, sa valeur par défaut est 0. La création de l’événement ne déplace pas le pointeur de souris réel.
Exécutez l’exemple dans la console du navigateur. Les résultats attendus sont 120, puis 0. Il s’agit d’une API Web, et non d’une fonctionnalité d’ECMAScript lui-même ; la présence de Node 24 dans un dépôt ne prouve pas que MouseEvent est disponible dans cet environnement.
Exemples
const event = new MouseEvent("mousemove", { clientY: 120 });
const defaultEvent = new MouseEvent("mousemove");
console.log(event.clientY);
console.log(defaultEvent.clientY);Résultat
120 0
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.