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