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

CKTIS / JavaScript

MouseEvent : bouton, coordonnées et touches modificatrices

Les champs de MouseEvent indiquent le bouton associé à un événement, les coordonnées du pointeur par rapport à la zone d’affichage et l’état de Ctrl, Meta, Shift et Alt. Distinguez button de buttons et les coordonnées de la zone d’affichage de celles du document.

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.button; event.clientX; event.clientY; event.ctrlKey; event.metaKey; event.shiftKey; event.altKey

MouseEvent est une interface de l’API Web des navigateurs, et non une partie d’ECMAScript lui-même. Ses propriétés d’instance sont en lecture seule. Dans un gestionnaire d’événement, lisez-les depuis l’objet reçu, par exemple event.clientX ; MouseEvent.clientX est une notation documentaire, et non l’accès à une propriété statique.

MouseEvent.button identifie le bouton enfoncé ou relâché : 0 — principal, 1 — auxiliaire, 2 — secondaire, 3 — généralement Précédent, 4 — généralement Suivant. Le bouton principal n’est pas forcément celui physiquement situé à gauche, car l’utilisateur peut modifier la configuration. 0 peut aussi indiquer un état non initialisé. N’utilisez pas button pour déterminer quels boutons sont maintenus pendant mousemove ; utilisez plutôt le masque de bits buttons.

MouseEvent.clientX et MouseEvent.clientY donnent les coordonnées horizontale et verticale en pixels par rapport à la zone d’affichage (viewport), et non à l’élément ou à l’ensemble du document. Les bords gauche et supérieur de la zone d’affichage correspondent à la valeur 0, même après le défilement du document. Ne supposez pas que les coordonnées doivent être des nombres entiers.

MouseEvent.ctrlKey, MouseEvent.metaKey, MouseEvent.shiftKey et MouseEvent.altKey sont des booléens qui décrivent respectivement l’état de Ctrl, Meta, Shift et Alt au moment de l’événement. Sur macOS, Meta correspond à Command ; sur les claviers Windows, à la touche Windows. Le système d’exploitation peut intercepter Meta. Sur macOS, Ctrl-clic ouvre un menu contextuel : ctrlKey n’est donc pas détectable dans cet événement click.

Ces champs et le constructeur sont largement pris en charge par les navigateurs ; la présence de Node 24 dans un dépôt ne démontre pas la prise en charge de l’API du navigateur. L’exemple crée un mousedown synthétique avec des données fixes : il ne déplace pas le pointeur et ne distribue pas l’événement à un élément.

Exemples

const event = new MouseEvent("mousedown", {
  button: 0,
  clientX: 120,
  clientY: 80,
  ctrlKey: true,
  metaKey: false,
  shiftKey: true,
  altKey: false
});

console.log(JSON.stringify({
  button: event.button,
  x: event.clientX,
  y: event.clientY,
  ctrl: event.ctrlKey,
  meta: event.metaKey,
  shift: event.shiftKey,
  alt: event.altKey
}));

Résultat

{"button":0,"x":120,"y":80,"ctrl":true,"meta":false,"shift":true,"alt":false}

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