Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje