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

CKTIS / JavaScript

MouseEvent : code du bouton et coordonnées dans la zone d’affichage

Utilisez `button` pour savoir quel bouton a été pressé ou relâché, et `clientX` et `clientY` pour situer l’événement de souris dans la zone d’affichage.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

event.button
 event.clientX
 event.clientY

new MouseEvent(type, { button, buttons, clientX, clientY })

button, clientX et clientY sont des propriétés d’instance de MouseEvent en lecture seule. Dans un gestionnaire, lisez event.button, pas MouseEvent.button. MouseEvent est une API du Web, pas une fonctionnalité d’ECMAScript 2024. Si l’environnement ne fournit pas le constructeur et que le nom n’est pas défini, new MouseEvent(...) lève une ReferenceError.

Dans des événements comme mousedown et mouseup, button indique le bouton pressé ou relâché : 0 principal (généralement à gauche), 1 auxiliaire (généralement au milieu), 2 secondaire (généralement à droite), 3 quatrième bouton (généralement Précédent), 4 cinquième bouton (généralement Suivant). Ce sont des rôles logiques, pas des positions physiques fixes. Dans mousemove, button === 0 ne prouve pas que le bouton principal est maintenu enfoncé. Utilisez le masque de bits buttons : 0 signifie qu’aucun bouton n’est enfoncé et (event.buttons & 1) !== 0 teste le bouton principal.

clientX et clientY donnent respectivement les coordonnées horizontale et verticale de l’événement en pixels CSS. Le coin supérieur gauche de la zone d’affichage (viewport) est à (0, 0) ; X augmente vers la droite et Y vers le bas. Le défilement ne déplace pas cette origine, mais peut changer les coordonnées client d’un même point du document lors d’un événement ultérieur. pageX et pageY se rapportent au document, screenX et screenY à l’écran. Les coordonnées client ne sont pas relatives à l’élément cible.

new MouseEvent(type, options) fixe les valeurs initiales d’un événement synthétique. Créer l’objet ne distribue pas l’événement et ne déplace pas le pointeur. L’événement a isTrusted === false et ne déclenche pas d’activation utilisateur.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>MouseEvent example</title>
<pre id="output"></pre>
<script>
  {
    const event = new MouseEvent("mouseup", {
      button: 2,
      buttons: 0,
      clientX: 120,
      clientY: 45,
    });

    document.getElementById("output").textContent =
      `button=${event.button}, buttons=${event.buttons}, clientX=${event.clientX}, clientY=${event.clientY}`;
  }
</script>

Résultat

button=2, buttons=0, clientX=120, clientY=45

Enregistrez l’exemple dans un fichier HTML et ouvrez-le dans un navigateur. Le `mouseup` synthétique décrit le relâchement du bouton secondaire en `(120, 45)` ; `buttons=0` signifie qu’aucun bouton ne reste enfoncé. Aucun clic n’est nécessaire.

Leçons associées

  • JavaScript · Leçon 35 · Intermédiaire · Version : 3

Sources