CKTIS / JavaScript
MouseEvent: kód tlačítka a souřadnice v oblasti zobrazení
Pomocí `button` zjistíš, které tlačítko myši bylo stisknuto nebo uvolněno. `clientX` a `clientY` určují polohu události v oblasti zobrazení.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
event.button
event.clientX
event.clientY
new MouseEvent(type, { button, buttons, clientX, clientY })button, clientX a clientY jsou vlastnosti instance MouseEvent pouze pro čtení. V obsluze události čti event.button, nikoli MouseEvent.button. MouseEvent je webové API, nikoli součást ECMAScriptu 2024. Pokud prostředí konstruktor neposkytuje a jeho jméno není definováno, new MouseEvent(...) vyvolá chybu ReferenceError.
U událostí jako mousedown a mouseup určuje button, které tlačítko bylo stisknuto nebo uvolněno: 0 hlavní (obvykle levé), 1 pomocné (obvykle prostřední), 2 sekundární (obvykle pravé), 3 čtvrté (obvykle Zpět), 4 páté (obvykle Vpřed). Jde o logické role, nikoli pevné fyzické pozice. Při mousemove hodnota button === 0 neprokazuje, že je hlavní tlačítko stisknuté. Použij bitovou masku buttons: 0 znamená, že není stisknuté žádné tlačítko, a (event.buttons & 1) !== 0 testuje hlavní tlačítko.
clientX a clientY jsou vodorovná a svislá souřadnice události v CSS pixelech. Levý horní roh oblasti zobrazení (viewportu) má souřadnice (0, 0); X roste doprava a Y dolů. Posouvání stránky tento počátek nemění, ale stejný bod dokumentu může mít při pozdější události jiné klientské souřadnice. pageX a pageY se vztahují k dokumentu a screenX a screenY k obrazovce. Klientské souřadnice se nevztahují k cílovému prvku.
Pomocí new MouseEvent(type, options) nastavíš počáteční hodnoty syntetické události. Vytvoření objektu událost nerozešle ani nepohne ukazatelem. Událost má isTrusted === false a nevyvolá aktivaci uživatele.
Pří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ýsledek
button=2, buttons=0, clientX=120, clientY=45
Ulož příklad jako soubor HTML a otevři ho v prohlížeči. Syntetická událost `mouseup` popisuje uvolnění sekundárního tlačítka v bodě `(120, 45)`; `buttons=0` znamená, že žádné tlačítko nezůstalo stisknuté. Není třeba klikat.
Související lekce
- JavaScript · Lekce 35 · Středně pokročilá · Verze: 3