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.altKeyMouseEvent 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.