CKTIS / JavaScript
MouseEvent: kôd tipke i koordinate područja prikaza
Svojstvo `button` otkriva koja je tipka miša pritisnuta ili otpuštena, a `clientX` i `clientY` daju položaj događaja unutar područja prikaza.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
event.button
event.clientX
event.clientY
new MouseEvent(type, { button, buttons, clientX, clientY })button, clientX i clientY svojstva su instance MouseEvent koja su dostupna samo za čitanje. U funkciji za obradu događaja čitaj event.button, a ne MouseEvent.button. MouseEvent je web API, a ne dio ECMAScripta 2024. Ako okruženje ne nudi konstruktor i naziv nije definiran, new MouseEvent(...) baca pogrešku ReferenceError.
U događajima kao što su mousedown i mouseup, button označava koja je tipka pritisnuta ili otpuštena: 0 primarna (obično lijeva), 1 pomoćna (obično srednja), 2 sekundarna (obično desna), 3 četvrta (obično Natrag), 4 peta (obično Naprijed). To su logičke uloge, ne fiksni fizički položaji. U događaju mousemove izraz button === 0 ne dokazuje da je primarna tipka pritisnuta. Upotrijebi bitovnu masku buttons: 0 znači da nijedna tipka nije pritisnuta, a (event.buttons & 1) !== 0 provjerava primarnu tipku.
clientX i clientY vodoravna su i okomita koordinata događaja u CSS pikselima. Gornji lijevi kut područja prikaza (viewporta) jest (0, 0); X raste udesno, a Y prema dolje. Pomicanje stranice ne mijenja to ishodište, ali ista točka dokumenta u kasnijem događaju može imati druge koordinate prikaza. pageX i pageY odnose se na dokument, a screenX i screenY na zaslon. Koordinate prikaza ne računaju se u odnosu na ciljni element.
S pomoću new MouseEvent(type, options) postavi početne vrijednosti sintetičkog događaja. Stvaranje objekta ne otprema događaj niti pomiče pokazivač. Događaj ima isTrusted === false i ne pokreće korisničku aktivaciju.
Primjeri
<!doctype html>
<meta charset="utf-8">
<title>MouseEvent example</title>
<pre id="output"></pre>
<script>
{
const event = new MouseEvent("mouseup", {
button: 2,
buttons: 0,
clientX: 120,
clientY: 45,
});
document.getElementById("output").textContent =
`button=${event.button}, buttons=${event.buttons}, clientX=${event.clientX}, clientY=${event.clientY}`;
}
</script>Rezultat
button=2, buttons=0, clientX=120, clientY=45
Spremi primjer kao HTML datoteku i otvori je u pregledniku. Sintetički `mouseup` opisuje otpuštanje sekundarne tipke u točki `(120, 45)`; `buttons=0` znači da nijedna tipka nije ostala pritisnuta. Nije potrebno kliknuti.
Povezane lekcije
- JavaScript · Lekcija 35 · Srednje · Verzija: 3