CKTIS / JavaScript
MouseEvent: knop, coördinaten en modificatietoetsen
MouseEvent-velden geven de knop aan die bij een gebeurtenis hoort, de aanwijzercoördinaten ten opzichte van de viewport en de status van Ctrl, Meta, Shift en Alt. Maak onderscheid tussen button en buttons, en tussen viewportcoördinaten en documentcoördinaten.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
event.button; event.clientX; event.clientY; event.ctrlKey; event.metaKey; event.shiftKey; event.altKeyMouseEvent is een browser-Web-API-interface en maakt geen deel uit van ECMAScript zelf. De instantie-eigenschappen zijn alleen-lezen. Lees ze in een event-handler uit het ontvangen object, bijvoorbeeld event.clientX; MouseEvent.clientX is documentatienotatie en geen toegang tot een statische eigenschap.
MouseEvent.button geeft aan welke knop is ingedrukt of losgelaten: 0 — primair, 1 — middelste, 2 — secundair, 3 — meestal Vorige, 4 — meestal Volgende. De primaire knop hoeft fysiek niet links te zitten, omdat gebruikers de configuratie kunnen wijzigen. 0 kan ook een niet-geïnitialiseerde status betekenen. Gebruik button niet om tijdens mousemove te bepalen welke knoppen ingedrukt worden gehouden; daarvoor gebruik je het bitmasker buttons.
MouseEvent.clientX en MouseEvent.clientY geven de horizontale en verticale coördinaat in pixels ten opzichte van de viewport, niet ten opzichte van het element of het hele document. De linker- en bovenrand van de viewport komen overeen met de waarde 0, ook nadat het document is gescrold. Ga er niet van uit dat coördinaten gehele getallen moeten zijn.
MouseEvent.ctrlKey, MouseEvent.metaKey, MouseEvent.shiftKey en MouseEvent.altKey zijn booleaanse waarden die respectievelijk de status van Ctrl, Meta, Shift en Alt op het moment van de gebeurtenis beschrijven. Meta is Command op macOS en de Windows-toets op Windows-toetsenborden. Het besturingssysteem kan Meta onderscheppen. Op macOS opent Ctrl-klikken een contextmenu, waardoor ctrlKey bij die click-gebeurtenis niet detecteerbaar is.
Deze velden en de constructor worden breed ondersteund in browsers; de aanwezigheid van Node 24 in een repository bewijst geen ondersteuning van de browser-API. Het voorbeeld maakt een synthetische mousedown met vaste gegevens: het verplaatst de aanwijzer niet en verstuurt de gebeurtenis niet naar een element.
Voorbeelden
const event = new MouseEvent("mousedown", {
button: 0,
clientX: 120,
clientY: 80,
ctrlKey: true,
metaKey: false,
shiftKey: true,
altKey: false
});
console.log(JSON.stringify({
button: event.button,
x: event.clientX,
y: event.clientY,
ctrl: event.ctrlKey,
meta: event.metaKey,
shift: event.shiftKey,
alt: event.altKey
}));Resultaat
{"button":0,"x":120,"y":80,"ctrl":true,"meta":false,"shift":true,"alt":false}De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.