Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Element.releasePointerCapture() — otpuštanje hvatanja pokazivača

releasePointerCapture(pointerId) otpušta hvatanje određenog pokazivača od strane elementa i vraća uobičajeno određivanje cilja događaja na temelju položaja.

Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

element.releasePointerCapture(pointerId)

Element.releasePointerCapture otpušta hvatanje pokazivača označenog s pointerId, koji se obično dobiva iz događaja. Metoda vraća undefined. Hvatanje usmjerava događaje prema elementu čak i izvan njegovih granica; otpuštanjem se vraća uobičajeno određivanje cilja na temelju položaja. Time se ne prekida fizički kontakt ni pritisak gumba.

Neaktivan identifikator uzrokuje DOMException naziva NotFoundError. Za aktivan pokazivač metoda ne radi ništa ako ga ovaj element ne hvata. hasPointerCapture(pointerId) provjerava stanje hvatanja na čekanju; otpuštanje odmah briše to stanje, ali se lostpointercapture ne mora emitirati sinkrono.

Preglednik otpušta hvatanje i nakon događaja pointerup ili pointercancel. Primjer ga otpušta ranije, pri prvom pomicanju nakon pritiska. Riječ je o API-ju Pointer Events u pregledniku, a ne o značajci ECMAScripta; Node 24 ne potvrđuje njegovu dostupnost. Provjerite podršku u ciljnim preglednicima.

Primjeri

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));
  }
});

Rezultat

undefined false

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori