Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła