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

CKTIS / JavaScript

Coordonnées de la souris : clientX, clientY, mousemove et mouseleave

Lis la position du pointeur dans la zone d’affichage, actualise l’interface au déplacement et réinitialise l’état quand le pointeur quitte un élément et ses descendants.

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

Syntaxe

element.addEventListener("mousemove", onMove);
element.addEventListener("mouseleave", onLeave);
// Inside a listener receiving a MouseEvent:
const x = event.clientX;
const y = event.clientY;

clientX et clientY sont des propriétés en lecture seule d’une instance de MouseEvent. Elles donnent les positions horizontale et verticale du pointeur au moment de l’évènement, en pixels CSS depuis le coin supérieur gauche de la zone d’affichage. Ce ne sont pas des coordonnées relatives au document, à l’écran ou à l’élément. Ces API appartiennent à la plateforme web, pas à ECMAScript 2024 ; leur disponibilité dépend de l’environnement d’exécution.

mousemove se déclenche lorsque le pointeur se déplace au-dessus d’un élément, même sans bouton enfoncé. Comme il peut se déclencher très souvent, limite le travail du gestionnaire. L’évènement remonte dans l’arbre DOM : s’il provient d’un descendant, event.target peut désigner ce descendant, tandis que event.currentTarget désigne, pendant l’exécution du gestionnaire, l’élément sur lequel il est enregistré.

mouseleave se déclenche lorsque le pointeur quitte l’élément et tous ses descendants. Contrairement à mouseout, il ne remonte pas dans l’arbre DOM. Passer de l’élément à un descendant ne déclenche pas mouseleave sur cet élément. C’est l’arbre DOM qui compte, pas seulement le rectangle visible. Utilise cet évènement pour réinitialiser l’état de survol, mais réinitialise-le toi-même si l’élément est supprimé ou remplacé.

Pour obtenir une position relative au coin supérieur gauche du rectangle englobant l’élément, récupère rect avec event.currentTarget.getBoundingClientRect() dans le gestionnaire, puis calcule event.clientX - rect.left et event.clientY - rect.top. Les deux paires utilisent le même repère : n’ajoute pas le décalage de défilement. La soustraction n’annule pas les transformations CSS.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>Mouse event propagation</title>
<pre id="output"></pre>
<script>
(() => {
  const output = document.getElementById("output");
  const lines = [];
  function log(line) {
    lines.push(line);
    console.log(line);
  }

  const area = document.createElement("div");
  const child = document.createElement("span");
  area.append(child);

  area.addEventListener("mousemove", (event) => {
    log(`move: ${event.clientX}, ${event.clientY}`);
  });
  area.addEventListener("mouseleave", () => log("leave"));

  child.dispatchEvent(new MouseEvent("mousemove", {
    bubbles: true, clientX: 24, clientY: 36
  }));
  child.dispatchEvent(new MouseEvent("mouseleave", { bubbles: false }));
  area.dispatchEvent(new MouseEvent("mouseleave", { bubbles: false }));

  output.textContent = lines.join("\n");
})();
</script>

Résultat

move: 24, 36
leave

Enregistre l’exemple dans un fichier HTML et ouvre-le dans un navigateur. Les éléments ne sont pas rattachés au document et les évènements sont synthétiques (`isTrusted` vaut `false`) : ils ne déplacent pas le pointeur et ne vérifient pas quel élément se trouve dessous. Le `mousemove` de l’enfant atteint le parent. Seul le `mouseleave` envoyé directement au parent affiche `leave`.

Leçons associées

  • JavaScript · Leçon 12 · Avancé · Version : 4

Sources