CKTIS / JavaScript
MouseEvent: knopcode en viewportcoördinaten
Gebruik `button` om te zien welke muisknop werd ingedrukt of losgelaten, en `clientX` en `clientY` om de positie van de gebeurtenis in de viewport te lezen.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
event.button
event.clientX
event.clientY
new MouseEvent(type, { button, buttons, clientX, clientY })button, clientX en clientY zijn alleen-lezen eigenschappen van een MouseEvent-instantie. Lees in een eventhandler event.button, niet MouseEvent.button. MouseEvent is een web-API en maakt geen deel uit van ECMAScript 2024. Als de omgeving de constructor niet aanbiedt en de naam niet is gedefinieerd, geeft new MouseEvent(...) een ReferenceError.
Bij gebeurtenissen zoals mousedown en mouseup geeft button aan welke knop is ingedrukt of losgelaten: 0 primair (meestal links), 1 hulpknop (meestal midden), 2 secundair (meestal rechts), 3 vierde knop (meestal Terug) en 4 vijfde knop (meestal Vooruit). Het zijn logische rollen, geen vaste fysieke posities. Bij mousemove bewijst button === 0 niet dat de primaire knop ingedrukt is. Gebruik het bitmasker buttons: 0 betekent dat geen knop is ingedrukt en (event.buttons & 1) !== 0 test de primaire knop.
clientX en clientY geven respectievelijk de horizontale en verticale coördinaat van de gebeurtenis in CSS-pixels. Linksboven in de viewport ligt (0, 0); X neemt naar rechts toe en Y naar beneden. Scrollen verplaatst die oorsprong niet, maar hetzelfde punt in het document kan bij een volgende gebeurtenis andere clientcoördinaten hebben. pageX en pageY zijn relatief aan het document, screenX en screenY aan het scherm. Clientcoördinaten zijn niet relatief aan het doelelement.
Met new MouseEvent(type, options) geef je een synthetische gebeurtenis beginwaarden. Het maken van het object verstuurt de gebeurtenis niet en verplaatst de aanwijzer niet. De gebeurtenis heeft isTrusted === false en levert geen gebruikersactivatie op.
Voorbeelden
<!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>Resultaat
button=2, buttons=0, clientX=120, clientY=45
Sla het voorbeeld op als HTML-bestand en open het in een browser. De synthetische `mouseup` beschrijft het loslaten van de secundaire knop op `(120, 45)`; `buttons=0` betekent dat geen knop ingedrukt blijft. Je hoeft niet te klikken.
Gerelateerde lessen
- JavaScript · Les 35 · Gemiddeld · Versie: 3