CKTIS / JavaScript
Element.releasePointerCapture() — uvolnění zachycení ukazatele
releasePointerCapture(pointerId) uvolní zachycení konkrétního ukazatele prvkem a obnoví běžné určování cíle událostí podle polohy.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
element.releasePointerCapture(pointerId)Element.releasePointerCapture uvolní zachycení ukazatele označeného pomocí pointerId, který se obvykle získá z události. Metoda vrací undefined. Zachycení směruje události do prvku i mimo jeho hranice; po uvolnění se obnoví běžné určování cíle podle polohy. Fyzický kontakt ani stisk tlačítka tím nekončí.
Neaktivní identifikátor vyvolá DOMException s názvem NotFoundError. U aktivního ukazatele metoda nic neudělá, pokud jej tento prvek nezachytil. hasPointerCapture(pointerId) kontroluje čekající stav zachycení; uvolnění tento stav ihned vymaže, ale událost lostpointercapture nemusí být vyvolána synchronně.
Prohlížeč uvolní zachycení také po události pointerup nebo pointercancel. Příklad jej uvolní dříve, při prvním pohybu po stisknutí. Jde o prohlížečové rozhraní Pointer Events, nikoli o funkci ECMAScriptu; Node 24 nedokládá jeho dostupnost. Ověřte podporu v cílových prohlížečích.
Příklady
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));
}
});Výsledek
undefined false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.