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

CKTIS / JavaScript

MouseEvent: tlačítko, souřadnice a modifikační klávesy

Pole MouseEvent zpřístupňují tlačítko související s událostí, souřadnice ukazatele vzhledem k zobrazované oblasti a stav kláves Ctrl, Meta, Shift a Alt. Rozlišujte button od buttons a souřadnice zobrazované oblasti od souřadnic dokumentu.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

event.button; event.clientX; event.clientY; event.ctrlKey; event.metaKey; event.shiftKey; event.altKey

MouseEvent je rozhraní Web API prohlížeče, nikoli součást samotného ECMAScriptu. Jeho vlastnosti instance jsou pouze pro čtení. V obslužné funkci události je čtěte z přijatého objektu, například event.clientX; MouseEvent.clientX je zápis používaný v dokumentaci, nikoli přístup ke statické vlastnosti.

MouseEvent.button určuje tlačítko, které bylo stisknuto nebo uvolněno: 0 — hlavní, 1 — prostřední, 2 — vedlejší, 3 — obvykle Zpět, 4 — obvykle Vpřed. Hlavní tlačítko nemusí být fyzicky vlevo, protože uživatel může změnit nastavení. 0 může také označovat neinicializovaný stav. Nepoužívejte button ke zjišťování, která tlačítka jsou během mousemove držena; k tomu slouží bitová maska buttons.

MouseEvent.clientX a MouseEvent.clientY udávají vodorovnou a svislou souřadnici v pixelech vzhledem k zobrazované oblasti (viewport), nikoli vzhledem k prvku nebo celému dokumentu. Levý a horní okraj zobrazované oblasti odpovídají hodnotě 0, a to i po posunutí dokumentu. Nepředpokládejte, že souřadnice musí být celá čísla.

MouseEvent.ctrlKey, MouseEvent.metaKey, MouseEvent.shiftKey a MouseEvent.altKey jsou logické hodnoty popisující stav kláves Ctrl, Meta, Shift a Alt v okamžiku události. Meta znamená Command v macOS a klávesu Windows na klávesnicích Windows. Operační systém může Meta zachytit. V macOS otevře Ctrl-kliknutí kontextovou nabídku, takže ctrlKey v této události click nelze zjistit.

Tato pole i konstruktor jsou v prohlížečích široce podporovány; přítomnost Node 24 v repozitáři nedokládá podporu API prohlížeče. Příklad vytvoří syntetickou událost mousedown s pevně nastavenými daty: nepohybuje ukazatelem ani neodesílá událost žádnému prvku.

Příklady

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
}));

Výsledek

{"button":0,"x":120,"y":80,"ctrl":true,"meta":false,"shift":true,"alt":false}

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje