CKTIS / JavaScript
MouseEvent: tlačidlo, súradnice a modifikačné klávesy
Polia MouseEvent sprístupňujú tlačidlo súvisiace s udalosťou, súradnice ukazovateľa vzhľadom na zobrazovanú oblasť a stav klávesov Ctrl, Meta, Shift a Alt. Rozlišujte button od buttons a súradnice zobrazovanej oblasti od súradníc dokumentu.
Verzia: 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 je rozhranie Web API prehliadača, nie súčasť samotného ECMAScriptu. Jeho vlastnosti inštancie sú iba na čítanie. V obslužnej funkcii udalosti ich čítajte z prijatého objektu, napríklad event.clientX; MouseEvent.clientX je zápis používaný v dokumentácii, nie prístup k statickej vlastnosti.
MouseEvent.button určuje tlačidlo, ktoré bolo stlačené alebo uvoľnené: 0 — hlavné, 1 — pomocné, 2 — vedľajšie, 3 — zvyčajne Späť, 4 — zvyčajne Dopredu. Hlavné tlačidlo nemusí byť fyzicky vľavo, pretože používateľ môže zmeniť nastavenie. 0 môže označovať aj neinicializovaný stav. Nepoužívajte button na určovanie tlačidiel držaných počas mousemove; na to slúži bitová maska buttons.
MouseEvent.clientX a MouseEvent.clientY udávajú vodorovnú a zvislú súradnicu v pixeloch vzhľadom na zobrazovanú oblasť (viewport), nie vzhľadom na prvok ani celý dokument. Ľavý a horný okraj zobrazovanej oblasti zodpovedajú hodnote 0, aj po posunutí dokumentu. Nepredpokladajte, že súradnice musia byť celé čísla.
MouseEvent.ctrlKey, MouseEvent.metaKey, MouseEvent.shiftKey a MouseEvent.altKey sú logické hodnoty, ktoré opisujú stav klávesov Ctrl, Meta, Shift a Alt v okamihu udalosti. Meta je Command v systéme macOS a kláves Windows na klávesniciach Windows. Operačný systém môže Meta zachytiť. V systéme macOS otvorí Ctrl-kliknutie kontextovú ponuku, takže ctrlKey v tejto udalosti click nemožno zistiť.
Tieto polia aj konštruktor sú v prehliadačoch široko podporované; prítomnosť Node 24 v repozitári nedokazuje podporu API prehliadača. Príklad vytvorí syntetickú udalosť mousedown s pevnými údajmi: nepohybuje ukazovateľom ani neodosiela udalosť prvku.
Príklady
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
}));Výsledok
{"button":0,"x":120,"y":80,"ctrl":true,"meta":false,"shift":true,"alt":false}Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.