Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje