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