Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

PointerEvent: identyfikator i główny wskaźnik

`pointerId` łączy zdarzenia tego samego aktywnego wskaźnika, a `isPrimary` określa, czy jest on głównym wskaźnikiem swojego typu.

Wersja: Current web platform; runtime support varies

Składnia

// Pointer Events Web API; no ECMAScript 2024 requirement
event.pointerId  // number, read-only
event.isPrimary  // boolean, read-only

pointerId to liczbowy identyfikator dostępny tylko do odczytu. Pozwala powiązać zdarzenia tego samego aktywnego wskaźnika i odróżnić go od innych aktywnych wskaźników, na przykład od drugiego punktu dotyku. Nie jest trwałym identyfikatorem urządzenia: nie wnioskuj o typie urządzenia na podstawie liczby i nie zakładaj, że kolejne interakcje dostaną ten sam identyfikator lub że nie zostanie on użyty ponownie. W zdarzeniu przeglądarki wartość -1 oznacza brak urządzenia wskazującego, na przykład przy click wywołanym klawiaturą.

isPrimary to właściwość logiczna tylko do odczytu. Wartość true oznacza główny wskaźnik w obrębie danego pointerType, a nie główny przycisk. Wskaźnik myszy jest główny; dla dotyku i pióra główny jest pierwszy wskaźnik danego typu, który staje się aktywny, gdy żaden inny wskaźnik tego typu nie jest aktywny. Mysz i dotyk mogą więc jednocześnie mieć isPrimary === true. Po zakończeniu głównego dotyku pozostałe aktywne kontakty nie stają się automatycznie główne.

Aby śledzić kilka gestów, zapisuj stan w Map pod kluczem pointerId przy pointerdown, odczytuj go przy pointermove i usuwaj przy pointerup lub pointercancel. Jeśli potrzebujesz jednego wskaźnika łącznie dla wszystkich typów, zapamiętaj wybrany identyfikator; sam filtr isPrimary nie wystarczy. Obie właściwości należą do API platformy webowej, a nie do ECMAScript; sprawdź obsługę w docelowym środowisku.

Przykłady

<!doctype html>
<meta charset="utf-8">
<title>PointerEvent example</title>
<pre id="output"></pre>
<script>
  const events = [
    new PointerEvent("pointerdown", { pointerType: "touch", pointerId: 7, isPrimary: true }),
    new PointerEvent("pointerdown", { pointerType: "touch", pointerId: 8, isPrimary: false }),
    new PointerEvent("pointermove", { pointerType: "touch", pointerId: 7, isPrimary: true }),
    new PointerEvent("pointermove", { pointerType: "mouse", pointerId: 12, isPrimary: true }),
  ];

  const lines = [];
  for (const event of events) {
    lines.push(`${event.type} ${event.pointerType} ${event.pointerId} ${event.isPrimary}`);
  }
  document.getElementById("output").textContent = lines.join("\n");
</script>

Wynik

pointerdown touch 7 true
pointerdown touch 8 false
pointermove touch 7 true
pointermove mouse 12 true

Zapisz przykład jako plik HTML i otwórz go w przeglądarce obsługującej `PointerEvent`. Wynik pojawi się na stronie. Identyfikator `7` łączy dwa zdarzenia dotyku, `8` oznacza inny kontakt, a mysz i pierwszy kontakt mają wartość `true`. Kod odczytuje jawnie ustawione wartości ze zdarzeń syntetycznych. Nie wysyła zdarzeń ani nie sprawdza, jak przeglądarka przypisuje wartości przy rzeczywistym wejściu.

Powiązane lekcje

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

Źródła