Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

MouseEvent: kod przycisku i współrzędne obszaru widoku

Użyj `button`, aby rozpoznać przycisk naciśnięty lub zwolniony w zdarzeniu, a `clientX` i `clientY`, aby odczytać pozycję tego zdarzenia w obszarze widoku.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

event.button
 event.clientX
 event.clientY

new MouseEvent(type, { button, buttons, clientX, clientY })

button, clientX i clientY to właściwości instancji MouseEvent tylko do odczytu: w procedurze obsługi zapisujesz event.button, a nie MouseEvent.button. Interfejs MouseEvent należy do platformy WWW, a nie do ECMAScript 2024. W środowisku bez tego konstruktora wywołanie new MouseEvent(...) zakończy się błędem ReferenceError, jeśli nazwa nie jest zdefiniowana.

W zdarzeniach takich jak mousedown i mouseup właściwość button wskazuje, który przycisk naciśnięto lub zwolniono: 0 — główny (zwykle lewy), 1 — pomocniczy (zwykle środkowy), 2 — dodatkowy (zwykle prawy), 3 — czwarty (zwykle Wstecz), 4 — piąty (zwykle Dalej). Są to role logiczne, nie stałe pozycje fizyczne. W mousemove wartość button === 0 nie dowodzi, że przycisk główny jest wciśnięty. Do sprawdzania stanu przycisków służy maska bitowa buttons: 0 oznacza brak wciśniętych przycisków, a (event.buttons & 1) !== 0 sprawdza przycisk główny.

clientX i clientY to odpowiednio pozioma i pionowa współrzędna zapisana w zdarzeniu, w pikselach CSS. Punkt (0, 0) znajduje się w lewym górnym rogu obszaru widoku (viewport); X rośnie w prawo, a Y w dół. Przewijanie nie przesuwa tego początku układu, ale może zmienić współrzędne tego samego punktu dokumentu w kolejnym zdarzeniu. pageX i pageY odnoszą się do dokumentu, screenX i screenY do ekranu, a współrzędne clientX i clientY nie są lokalne względem elementu docelowego.

Konstruktor new MouseEvent(type, options) pozwala nadać zdarzeniu syntetycznemu wartości początkowe. Samo utworzenie obiektu nie rozsyła zdarzenia ani nie przesuwa wskaźnika. Takie zdarzenie ma isTrusted === false i nie nadaje aktywacji użytkownika.

Przykłady

<!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>

Wynik

button=2, buttons=0, clientX=120, clientY=45

Zapisz przykład jako plik HTML i otwórz go w przeglądarce. Syntetyczne `mouseup` opisuje zwolnienie przycisku dodatkowego przy `(120, 45)`; `buttons=0` oznacza, że żaden przycisk nie pozostaje wciśnięty. Nie trzeba klikać.

Powiązane lekcje

  • JavaScript · Lekcja 35 · Średniozaawansowany · Wersja: 3

Źródła