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.