Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

PointerEvent: identyfikator wskaźnika i współrzędne w obszarze widoku

`pointerId` pozwala rozróżnić jednocześnie aktywne wskaźniki, a `clientX` i `clientY` określają pozycję zdarzenia w obszarze widoku w pikselach CSS.

Wersja: Current web platform; runtime support varies

Składnia

event.pointerId
 event.clientX
 event.clientY

pointerId, clientX i clientY to właściwości instancji PointerEvent dostępne tylko do odczytu. pointerId to liczbowy identyfikator odróżniający dany wskaźnik od innych aktywnych w tym samym czasie, na przykład dwa palce na ekranie. Identyfikator może zostać ponownie użyty po zakończeniu interakcji. Nie traktuj go jako trwałego identyfikatora urządzenia ani nie wnioskuj z niego o typie urządzenia. W zdarzeniu przeglądarki wartość -1 oznacza, że zdarzenia nie wywołało urządzenie wskazujące, na przykład gdy przycisk aktywowano klawiaturą.

clientX (pozioma) i clientY (pionowa) są dziedziczone z MouseEvent także w zdarzeniach dotyku i pióra. Określają pozycję zdarzenia w pikselach CSS względem lewego górnego rogu obszaru widoku (viewportu); wartości rosną odpowiednio w prawo i w dół. pageX i pageY odnoszą się natomiast do dokumentu. Współrzędne clientX i clientY nie są też liczone względem elementu docelowego ani ekranu. Przewinięcie dokumentu zmienia współrzędne tego samego punktu dokumentu w obszarze widoku, ale nie przesuwa początku układu współrzędnych tego obszaru.

Aby śledzić kilka interakcji, przy pointerdown zapisz pozycję początkową w Map pod kluczem pointerId. Przy pointermove odczytaj wpis dla tego identyfikatora; jeśli wpisu nie ma, pomiń zdarzenie. Usuń wpis zarówno przy pointerup, jak i przy pointercancel. PointerEvent i właściwości współrzędnych dziedziczone z MouseEvent należą do API platformy webowej. Ani te właściwości, ani przykład nie wymagają ECMAScript 2024. Dostępność API zależy od środowiska wykonawczego.

Przykłady

(() => {
  const target = new EventTarget();
  const starts = new Map();

  target.addEventListener("pointerdown", ({ pointerId, clientX, clientY }) => {
    starts.set(pointerId, { x: clientX, y: clientY });
  });
  target.addEventListener("pointermove", ({ pointerId, clientX, clientY }) => {
    const start = starts.get(pointerId);
    if (!start) return;
    console.log(`${pointerId}: dx=${clientX - start.x}, dy=${clientY - start.y}`);
  });
  const end = ({ pointerId }) => { starts.delete(pointerId); };
  target.addEventListener("pointerup", end);
  target.addEventListener("pointercancel", end);

  const send = (type, pointerId, clientX, clientY) => {
    const fields = { pointerId, clientX, clientY };
    // Without PointerEvent, use a plain Event to exercise the same listeners.
    const event = typeof PointerEvent === "function"
      ? new PointerEvent(type, fields)
      : Object.assign(new Event(type), fields);
    target.dispatchEvent(event);
  };

  send("pointerdown", 7, 100, 80);
  send("pointerdown", 8, 200, 150);
  send("pointermove", 7, 112, 75);
  send("pointermove", 8, 197, 159);
  send("pointercancel", 8, 197, 159);
  send("pointermove", 8, 198, 160);
  send("pointerup", 7, 112, 75);
  console.log(`tracked=${starts.size}`);
})();

Wynik

7: dx=12, dy=-5
8: dx=-3, dy=9
tracked=0

Uruchom kod w Node.js lub w konsoli przeglądarki. Jeśli `PointerEvent` jest niedostępny, kod przekazuje tym samym procedurom obsługi zwykłe obiekty `Event` z trzema polami. Syntetyczne zdarzenia mają `isTrusted === false` i nie poruszają fizycznym wskaźnikiem. Kod wypisuje przesunięcie względem początku każdej interakcji. Ruch wskaźnika `8` po anulowaniu jest ignorowany; `tracked=0` oznacza, że nie pozostał żaden wpis.

Powiązane lekcje

  • JavaScript · Lekcja 35 · Zaawansowany · Wersja: 4

Źródła