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