CKTIS / JavaScript
MouseEvent: przycisk, współrzędne i klawisze modyfikujące
Pola MouseEvent pozwalają odczytać przycisk związany ze zdarzeniem, położenie wskaźnika względem obszaru widoku oraz stan klawiszy Ctrl, Meta, Shift i Alt. Rozróżniaj button od buttons oraz współrzędne widoku od współrzędnych dokumentu.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
event.button; event.clientX; event.clientY; event.ctrlKey; event.metaKey; event.shiftKey; event.altKeyMouseEvent to interfejs przeglądarkowego Web API, a nie część samego ECMAScript. Jego właściwości instancji są tylko do odczytu. W procedurze obsługi zdarzenia odczytujesz je z otrzymanego obiektu, np. event.clientX; zapis MouseEvent.clientX jest nazwą dokumentacyjną, nie dostępem do właściwości statycznej.
MouseEvent.button określa przycisk naciśnięty lub zwolniony: 0 — główny, 1 — pomocniczy, 2 — dodatkowy, 3 — zwykle Wstecz, 4 — zwykle Dalej. Główny przycisk nie musi być fizycznie lewy, ponieważ użytkownik może zmienić konfigurację. 0 może też oznaczać stan niezainicjalizowany. Nie używaj button do ustalania przytrzymanych przycisków podczas mousemove; służy do tego maska bitowa buttons.
MouseEvent.clientX i MouseEvent.clientY podają odpowiednio poziomą i pionową współrzędną w pikselach względem obszaru widoku (viewport), nie elementu ani całego dokumentu. Lewa i górna krawędź widoku odpowiadają wartości 0, także po przewinięciu dokumentu. Nie zakładaj, że współrzędne muszą być całkowite.
MouseEvent.ctrlKey, MouseEvent.metaKey, MouseEvent.shiftKey i MouseEvent.altKey są wartościami logicznymi opisującymi stan odpowiednio Ctrl, Meta, Shift i Alt w chwili zdarzenia. Meta to Command na macOS, a na klawiaturach Windows — klawisz Windows. System może przechwycić Meta. Na macOS Ctrl z kliknięciem otwiera menu kontekstowe, więc ctrlKey nie jest wtedy wykrywalne w zdarzeniu click.
Te pola i konstruktor są szeroko obsługiwane przez przeglądarki; obecność Node 24 w repozytorium nie potwierdza obsługi przeglądarkowego API. Przykład tworzy syntetyczny mousedown z ustalonymi danymi: nie przesuwa wskaźnika ani nie wysyła zdarzenia do elementu.
Przykłady
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
}));Wynik
{"button":0,"x":120,"y":80,"ctrl":true,"meta":false,"shift":true,"alt":false}Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.