Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Element.releasePointerCapture() — zwalnianie przechwycenia wskaźnika

releasePointerCapture(pointerId) zwalnia przechwycenie konkretnego wskaźnika przez element, przywracając zwykłe wyznaczanie celu zdarzeń na podstawie położenia.

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

element.releasePointerCapture(pointerId)

Element.releasePointerCapture zwalnia przechwycenie wskaźnika wskazanego przez pointerId, zwykle pobrany ze zdarzenia. Zwraca undefined. Przechwycenie kieruje zdarzenia do elementu nawet poza jego obszarem; zwolnienie przywraca zwykłe wyznaczanie celu według położenia. Nie kończy fizycznego kontaktu ani naciśnięcia.

Nieaktywny identyfikator powoduje DOMException o nazwie NotFoundError. Dla aktywnego wskaźnika metoda nic nie robi, jeśli element nie ma przechwycenia. hasPointerCapture(pointerId) sprawdza oczekujący stan przechwycenia; zwolnienie usuwa go od razu, lecz lostpointercapture nie musi zostać wyemitowane synchronicznie.

Przeglądarka zwalnia przechwycenie również po pointerup lub pointercancel. Przykład zwalnia je wcześniej, przy pierwszym ruchu po naciśnięciu. To przeglądarkowe API Pointer Events, nie funkcja ECMAScript; Node 24 nie dowodzi jego dostępności. Obsługę należy sprawdzić w docelowych przeglądarkach.

Przykłady

const pad = document.createElement('button');
pad.textContent = 'Press and move';
pad.style.touchAction = 'none';
document.body.append(pad);

pad.addEventListener('pointerdown', (event) => {
  pad.setPointerCapture(event.pointerId);
});

pad.addEventListener('pointermove', (event) => {
  if (pad.hasPointerCapture(event.pointerId)) {
    const result = pad.releasePointerCapture(event.pointerId);
    console.log(result, pad.hasPointerCapture(event.pointerId));
  }
});

Wynik

undefined false

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła