Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.altKey

MouseEvent 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.

Zdroje