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.clientYpointerId, 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