KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Muiscoördinaten: clientX, clientY, mousemove en mouseleave

Lees de aanwijzerpositie ten opzichte van de viewport, werk de interface bij bij beweging en herstel de toestand zodra de aanwijzer een element en zijn afstammelingen verlaat.

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

Syntax

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

clientX en clientY zijn alleen-lezen-eigenschappen van een MouseEvent-instantie. Ze geven de horizontale en verticale positie van de aanwijzer op het moment van de gebeurtenis, in CSS-pixels vanaf de linkerbovenhoek van de viewport. Dit zijn geen document-, scherm- of elementcoördinaten. Deze API’s horen bij het webplatform, niet bij ECMAScript 2024; de beschikbaarheid hangt af van de uitvoeromgeving.

mousemove treedt op wanneer de aanwijzer over een element beweegt, ook zonder ingedrukte muisknop. Dat kan heel vaak gebeuren, dus houd de handler licht. De gebeurtenis gaat omhoog in de DOM-boom (bubbling): komt ze van een afstammeling, dan kan event.target die afstammeling zijn, terwijl event.currentTarget tijdens de uitvoering van de handler het element met de listener aanwijst.

mouseleave treedt op wanneer de aanwijzer het element en al zijn afstammelingen verlaat. Anders dan mouseout gaat deze gebeurtenis niet omhoog in de DOM-boom. Bewegen van het element naar een afstammeling veroorzaakt geen mouseleave op dat element. De DOM-boom is bepalend, niet alleen de zichtbare rechthoek. Gebruik deze gebeurtenis om de hoverstatus te wissen, maar wis die zelf als het element wordt verwijderd of vervangen.

Voor een positie ten opzichte van de linkerbovenhoek van de begrenzende rechthoek lees je binnen de handler rect uit met event.currentTarget.getBoundingClientRect(). Bereken vervolgens event.clientX - rect.left en event.clientY - rect.top. Beide paren gebruiken hetzelfde coördinatenstelsel, dus tel er geen scrollafstand bij op. Aftrekken maakt CSS-transformaties niet ongedaan.

Voorbeelden

<!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>

Resultaat

move: 24, 36
leave

Sla het voorbeeld op als HTML-bestand en open het in een browser. De elementen zijn niet aan het document gekoppeld en de gebeurtenissen zijn synthetisch (`isTrusted` is `false`): ze verplaatsen de aanwijzer niet en testen niet welk element eronder ligt. De `mousemove` van het kind bereikt het bovenliggende element. Alleen de `mouseleave` die rechtstreeks aan dat element wordt verzonden, toont `leave`.

Gerelateerde lessen

  • JavaScript · Les 12 · Gevorderd · Versie: 4

Bronnen