CKTIS / JavaScript
Element.releasePointerCapture() — uvoľnenie zachytenia ukazovateľa
releasePointerCapture(pointerId) uvoľní zachytenie konkrétneho ukazovateľa prvkom a obnoví bežné určovanie cieľa udalostí podľa polohy.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
element.releasePointerCapture(pointerId)Element.releasePointerCapture uvoľní zachytenie ukazovateľa označeného pomocou pointerId, ktorý sa zvyčajne získa z udalosti. Metóda vracia undefined. Zachytenie smeruje udalosti do prvku aj mimo jeho hraníc; po uvoľnení sa obnoví bežné určovanie cieľa podľa polohy. Fyzický kontakt ani stlačenie tlačidla sa tým nekončí.
Neaktívny identifikátor vyvolá DOMException s názvom NotFoundError. Pri aktívnom ukazovateli metóda nič neurobí, ak ho tento prvok nezachytil. hasPointerCapture(pointerId) kontroluje čakajúci stav zachytenia; uvoľnenie tento stav okamžite vymaže, no udalosť lostpointercapture sa nemusí vyvolať synchrónne.
Prehliadač uvoľní zachytenie aj po udalosti pointerup alebo pointercancel. Príklad ho uvoľní skôr, pri prvom pohybe po stlačení. Ide o prehliadačové rozhranie Pointer Events, nie o funkciu ECMAScriptu; Node 24 nedokazuje jeho dostupnosť. Overte podporu v cieľových prehliadačoch.
Prí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ýsledok
undefined false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.