CKTIS / JavaScript
MouseEvent: kód tlačidla a súradnice v oblasti zobrazenia
Pomocou `button` zistíš, ktoré tlačidlo myši bolo stlačené alebo uvoľnené. `clientX` a `clientY` určujú polohu udalosti v oblasti zobrazenia.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
event.button
event.clientX
event.clientY
new MouseEvent(type, { button, buttons, clientX, clientY })button, clientX a clientY sú vlastnosti inštancie MouseEvent len na čítanie. V obsluhe udalosti čítaj event.button, nie MouseEvent.button. MouseEvent je webové API, nie súčasť ECMAScriptu 2024. Ak prostredie neposkytuje konštruktor a jeho názov nie je definovaný, new MouseEvent(...) vyvolá chybu ReferenceError.
Pri udalostiach ako mousedown a mouseup určuje button, ktoré tlačidlo bolo stlačené alebo uvoľnené: 0 hlavné (zvyčajne ľavé), 1 pomocné (zvyčajne stredné), 2 sekundárne (zvyčajne pravé), 3 štvrté (zvyčajne Späť), 4 piate (zvyčajne Dopredu). Ide o logické roly, nie pevné fyzické pozície. Pri mousemove hodnota button === 0 nedokazuje, že je hlavné tlačidlo stlačené. Použi bitovú masku buttons: 0 znamená, že nie je stlačené žiadne tlačidlo, a (event.buttons & 1) !== 0 testuje hlavné tlačidlo.
clientX a clientY sú vodorovná a zvislá súradnica udalosti v pixeloch CSS. Ľavý horný roh oblasti zobrazenia (viewportu) je (0, 0); X rastie doprava a Y nadol. Posúvanie stránky nemení tento začiatok, ale ten istý bod dokumentu môže mať pri neskoršej udalosti iné klientské súradnice. pageX a pageY sa vzťahujú na dokument, screenX a screenY na obrazovku. Klientské súradnice sa nevzťahujú na cieľový prvok.
Pomocou new MouseEvent(type, options) nastavíš počiatočné hodnoty syntetickej udalosti. Samotné vytvorenie objektu udalosť neodošle ani nepohne ukazovateľom. Udalosť má isTrusted === false a nespôsobí aktiváciu používateľa.
Príklady
<!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>Výsledok
button=2, buttons=0, clientX=120, clientY=45
Ulož príklad ako súbor HTML a otvor ho v prehliadači. Syntetická udalosť `mouseup` opisuje uvoľnenie sekundárneho tlačidla v bode `(120, 45)`; `buttons=0` znamená, že žiadne tlačidlo nezostalo stlačené. Netreba kliknúť.
Súvisiace lekcie
- JavaScript · Lekcia 35 · Stredne pokročilá · Verzia: 3