CKTIS / JavaScript
PointerEvent — zdarzenia wskaźnika i przechwytywanie
PointerEvent ujednolica obsługę myszy, dotyku i pióra. Poznaj identyfikatory wskaźników, współrzędne, cykl interakcji oraz przechwytywanie zdarzeń podczas przeciągania.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
new PointerEvent(type, options)
element.addEventListener('pointerdown', handler)
element.setPointerCapture(event.pointerId)
element.releasePointerCapture(event.pointerId)PointerEvent to przeglądarkowy interfejs Web API dziedziczący po MouseEvent, wspólny dla myszy, dotyku i pióra. Nie jest funkcją określonej edycji ECMAScript. Sprawdź dostępność przez 'PointerEvent' in window; obecność Node 24 w repozytorium nie potwierdza obsługi w przeglądarce.
PointerEvent.pointerId identyfikuje aktywny wskaźnik; identyfikatory mogą być później użyte ponownie i nie są trwałymi identyfikatorami urządzeń. PointerEvent.isPrimary wskazuje wskaźnik główny danego typu, nie globalnie jedyny wskaźnik. Mysz i dotyk mogą więc jednocześnie mieć wskaźnik główny. PointerEvent.clientX i PointerEvent.clientY, odziedziczone po MouseEvent, podają współrzędne względem obszaru widoku w pikselach CSS, nie względem elementu ani początku dokumentu.
Cykl obejmuje pointerdown, pointermove oraz zakończenie przez pointerup lub pointercancel. Przy anulowaniu również usuń stan interakcji, np. gdy przeglądarka przejmie gest. pointerover/pointerout i pointerenter/pointerleave opisują granice elementów; nie zastępują zakończenia interakcji.
Wywołane podczas rzeczywistego pointerdown element.setPointerCapture(event.pointerId) kieruje kolejne zdarzenia tego wskaźnika do elementu również poza jego granicami. gotpointercapture i lostpointercapture sygnalizują przejęcie i utratę przechwytywania; element.releasePointerCapture(event.pointerId) zwalnia je jawnie. Zwolnienie następuje też po pointerup lub pointercancel. Dotyk może uzyskać przechwytywanie automatycznie. Obsłuż utratę przechwytywania, aby nie pozostawić aktywnego przeciągania.
Dla własnych gestów deklaruj odpowiednie CSS touch-action przed rozpoczęciem interakcji; samo preventDefault() nie blokuje przewijania i powiększania obszaru widoku. Przykład celowo wysyła zdarzenia syntetyczne: sprawdza pola i usuwanie stanu, ale nie uruchamia rzeczywistego wejścia sprzętowego ani przechwytywania.
Przykłady
const target = document.createElement('div');
const active = new Map();
const lines = [];
for (const type of ['pointerdown', 'pointermove', 'pointerup', 'pointercancel']) {
target.addEventListener(type, (event) => {
const { pointerId, isPrimary, clientX, clientY } = event;
if (type === 'pointerdown') active.set(pointerId, true);
if (!active.has(pointerId)) return;
lines.push(`${type} ${pointerId} ${isPrimary} ${clientX},${clientY}`);
if (type === 'pointerup' || type === 'pointercancel') {
active.delete(pointerId);
}
});
}
for (const [type, clientX, clientY] of [
['pointerdown', 10, 20],
['pointermove', 15, 25],
['pointerup', 15, 25]
]) {
target.dispatchEvent(new PointerEvent(type, {
pointerId: 7, pointerType: 'touch', isPrimary: true,
clientX, clientY
}));
}
console.log(lines.join('\n'));
console.log(`active=${active.size}`);Wynik
pointerdown 7 true 10,20 pointermove 7 true 15,25 pointerup 7 true 15,25 active=0
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.