Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.clientY

MouseEvent.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.

Sources