Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

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

Źródła