CKTIS / JavaScript
Element.releasePointerCapture() — rilasciare la cattura del puntatore
releasePointerCapture(pointerId) rilascia la cattura di un puntatore specifico da parte di un elemento e ripristina il normale targeting degli eventi in base alla posizione.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
element.releasePointerCapture(pointerId)Element.releasePointerCapture rilascia la cattura del puntatore identificato da pointerId, normalmente ottenuto da un evento. Restituisce undefined. La cattura indirizza gli eventi all’elemento anche quando il puntatore è al di fuori dei suoi limiti; rilasciandola, si ripristina il normale targeting in base alla posizione. Non termina il contatto fisico né la pressione di un pulsante.
Un identificatore inattivo genera una DOMException denominata NotFoundError. Per un puntatore attivo, il metodo non fa nulla se l’elemento non ne ha la cattura. hasPointerCapture(pointerId) controlla lo stato di cattura in attesa; il rilascio cancella subito tale stato, ma lostpointercapture non deve necessariamente essere emesso in modo sincrono.
Il browser rilascia la cattura anche dopo pointerup o pointercancel. L’esempio la rilascia prima, al primo movimento dopo la pressione. Questa è un’API Pointer Events del browser, non una funzionalità ECMAScript; Node 24 non dimostra che sia disponibile. Verifica il supporto nei browser di destinazione.
Esempi
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));
}
});Risultato
undefined false
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.