Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

MouseEvent: gumb, koordinate in modifikacijske tipke

Polja MouseEvent omogočajo dostop do gumba, povezanega z dogodkom, koordinat kazalca glede na območje prikaza ter stanja tipk Ctrl, Meta, Shift in Alt. Razlikujte med button in buttons ter med koordinatami območja prikaza in koordinatami dokumenta.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

event.button; event.clientX; event.clientY; event.ctrlKey; event.metaKey; event.shiftKey; event.altKey

MouseEvent je vmesnik spletnega API-ja brskalnika in ni del samega ECMAScripta. Njegove lastnosti primerka so samo za branje. V obravnavalniku dogodka jih preberite iz prejetega objekta, na primer event.clientX; MouseEvent.clientX je zapis iz dokumentacije, ne dostop do statične lastnosti.

MouseEvent.button določa gumb, ki je bil pritisnjen ali sproščen: 0 — glavni, 1 — pomožni, 2 — sekundarni, 3 — običajno Nazaj, 4 — običajno Naprej. Glavni gumb ni nujno fizično levi, saj lahko uporabnik spremeni nastavitev. 0 lahko pomeni tudi neinicializirano stanje. Z button ne ugotavljajte, kateri gumbi so med mousemove zadržani; za to uporabite bitno masko buttons.

MouseEvent.clientX in MouseEvent.clientY podajata vodoravno oziroma navpično koordinato v slikovnih pikah glede na območje prikaza (viewport), ne glede na element ali celoten dokument. Levi in zgornji rob območja prikaza ustrezata vrednosti 0, tudi po pomiku dokumenta. Ne predpostavljajte, da morajo biti koordinate cela števila.

MouseEvent.ctrlKey, MouseEvent.metaKey, MouseEvent.shiftKey in MouseEvent.altKey so logične vrednosti, ki opisujejo stanje tipk Ctrl, Meta, Shift oziroma Alt v trenutku dogodka. Meta je v sistemu macOS tipka Command, na tipkovnicah Windows pa tipka Windows. Operacijski sistem lahko prestreže Meta. V sistemu macOS Ctrl-klik odpre kontekstni meni, zato ctrlKey v tem dogodku click ni mogoče zaznati.

Ta polja in konstruktor so v brskalnikih široko podprti; prisotnost Node 24 v repozitoriju ne potrjuje podpore za API brskalnika. Primer ustvari sintetični mousedown s fiksnimi podatki: ne premakne kazalca in dogodka ne pošlje elementu.

Primeri

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
}));

Rezultat

{"button":0,"x":120,"y":80,"ctrl":true,"meta":false,"shift":true,"alt":false}

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri