CKTIS / JavaScript
Element.setPointerCapture — zachytenie ukazovateľa
Metóda setPointerCapture(pointerId) smeruje nasledujúce udalosti konkrétneho ukazovateľa na zvolený prvok, aj keď ukazovateľ opustí jeho hranice. Uľahčuje presúvanie myšou, dotykom alebo perom.
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.setPointerCapture(pointerId)Zavolajte Element.setPointerCapture na prvku, zvyčajne v obsluhe pointerdown, a odovzdajte event.pointerId. Zachytenie nahrádza bežný výber cieľa podľa polohy, takže prvok naďalej prijíma napríklad udalosti pointermove aj mimo svojich hraníc. Metóda vracia undefined; kurzor nepohybuje ani nezamyká.
Volanie nastaví čakajúce zachytenie: hasPointerCapture(pointerId) môže okamžite vrátiť true, ešte pred udalosťou gotpointercapture. releasePointerCapture(pointerId) zachytenie výslovne uvoľní; po pointerup alebo pointercancel ho prehliadač uvoľní automaticky. Udalosť lostpointercapture použite na vyčistenie stavu interakcie. Dotykový vstup už môže mať implicitné zachytenie.
Identifikátor, ktorý nezodpovedá žiadnemu aktívnemu ukazovateľu, vyvolá NotFoundError. Odpojený prvok alebo aktívny Pointer Lock v jeho dokumente vyvolá InvalidStateError. Až po úspešnej kontrole identifikátora ukazovateľa, pripojenia prvku a stavu Pointer Lock metóda posúdi zvyšné podmienky: ak nie je stlačené žiadne tlačidlo ani nedochádza ku kontaktu alebo ak dokument prvku nie je aktívnym dokumentom ukazovateľa, metóda zachytenie nenastaví a nevyvolá chybu.
Zachytenie nevypína posúvanie ani približovanie dotykom; príklad používa touch-action: none iba v demonštračnej oblasti. Ide o API prehliadača špecifikované v Pointer Events, nie o funkciu konkrétnej edície ECMAScript. Samotná prítomnosť Node 24 nedokazuje dostupnosť: overte metódu a otestujte cieľové prehliadače.
Príklady
const pad = document.createElement('div');
pad.textContent = 'Press, move outside, release';
pad.style.cssText = 'width:220px;height:100px;background:lightblue;touch-action:none;user-select:none';
const log = document.createElement('pre');
document.body.append(pad, log);
if (typeof pad.setPointerCapture !== 'function') {
log.textContent = 'unsupported';
} else {
let activeId = null;
pad.addEventListener('pointerdown', (event) => {
if (activeId !== null) return;
pad.setPointerCapture(event.pointerId);
activeId = event.pointerId;
log.textContent = `pending: ${pad.hasPointerCapture(activeId)}`;
});
pad.addEventListener('pointermove', (event) => {
if (event.pointerId === activeId) {
log.textContent = 'moving';
}
});
pad.addEventListener('lostpointercapture', (event) => {
if (event.pointerId === activeId) {
activeId = null;
log.textContent = 'released';
}
});
}Výsledok
released
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.