Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

MouseEvent: gumb, koordinate i modifikacijske tipke

Polja MouseEvent omogućuju dohvat gumba povezanog s događajem, koordinata pokazivača u odnosu na područje prikaza te stanja tipki Ctrl, Meta, Shift i Alt. Razlikujte button od buttons te koordinate područja prikaza od koordinata dokumenta.

Verzija: 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 sučelje Web API-ja preglednika, a ne dio samog ECMAScripta. Njegova svojstva instance samo su za čitanje. U rukovatelju događajem čitajte ih iz primljenog objekta, primjerice event.clientX; MouseEvent.clientX zapis je iz dokumentacije, a ne pristup statičkom svojstvu.

MouseEvent.button određuje gumb koji je pritisnut ili otpušten: 0 — glavni, 1 — pomoćni, 2 — sekundarni, 3 — obično Natrag, 4 — obično Naprijed. Glavni gumb ne mora fizički biti lijevi jer korisnik može promijeniti postavke. 0 može označavati i neinicijalizirano stanje. Nemojte koristiti button za određivanje gumba koji se drže tijekom mousemove; za to služi bitna maska buttons.

MouseEvent.clientX i MouseEvent.clientY daju vodoravnu i okomitu koordinatu u pikselima u odnosu na područje prikaza (viewport), a ne na element ili cijeli dokument. Lijevi i gornji rub područja prikaza odgovaraju vrijednosti 0, čak i nakon pomicanja dokumenta. Nemojte pretpostaviti da koordinate moraju biti cijeli brojevi.

MouseEvent.ctrlKey, MouseEvent.metaKey, MouseEvent.shiftKey i MouseEvent.altKey booleove su vrijednosti koje opisuju stanje tipki Ctrl, Meta, Shift odnosno Alt u trenutku događaja. Meta je Command na macOS-u, a tipka Windows na Windows tipkovnicama. Operacijski sustav može presresti Meta. Na macOS-u Ctrl-klik otvara kontekstni izbornik, pa se ctrlKey ne može detektirati u tom događaju click.

Ova polja i konstruktor široko su podržani u preglednicima; prisutnost Node 24 u repozitoriju ne dokazuje podršku za API preglednika. Primjer stvara sintetički mousedown s fiksnim podacima: ne pomiče pokazivač niti šalje događaj elementu.

Primjeri

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}

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori