Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Element.setPointerCapture — hvatanje pokazivača

Metoda setPointerCapture(pointerId) usmjerava sljedeće događaje određenog pokazivača na odabrani element, čak i kada pokazivač napusti njegove granice. Olakšava povlačenje mišem, dodirom ili olovkom.

Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

element.setPointerCapture(pointerId)

Pozovite Element.setPointerCapture na elementu, obično unutar rukovatelja pointerdown, i proslijedite event.pointerId. Hvatanje zamjenjuje uobičajeni odabir cilja na temelju položaja, pa element nastavlja primati događaje poput pointermove i izvan svojih granica. Metoda vraća undefined; ne pomiče niti zaključava pokazivač.

Poziv postavlja hvatanje na čekanju: hasPointerCapture(pointerId) može odmah vratiti true, prije događaja gotpointercapture. releasePointerCapture(pointerId) izričito otpušta hvatanje; nakon pointerup ili pointercancel preglednik ga otpušta automatski. Za čišćenje stanja interakcije upotrijebite lostpointercapture. Unos dodirom možda već ima implicitno hvatanje.

Identifikator koji ne odgovara nijednom aktivnom pokazivaču uzrokuje NotFoundError. Odspojen element ili aktivni Pointer Lock u njegovu dokumentu uzrokuje InvalidStateError. Tek nakon uspješne provjere identifikatora pokazivača, povezanosti elementa i stanja Pointer Locka metoda provjerava preostale uvjete: ako nema ni pritisnutog gumba ni kontakta ili ako dokument elementa nije aktivni dokument pokazivača, metoda ne postavlja hvatanje i ne prijavljuje pogrešku.

Hvatanje ne isključuje pomicanje ni zumiranje dodirom; primjer upotrebljava touch-action: none samo na demonstracijskom području. Ovo je API preglednika definiran specifikacijom Pointer Events, a ne značajka određenog izdanja ECMAScripta. Sama prisutnost Nodea 24 ne dokazuje dostupnost: provjerite metodu i testirajte ciljane preglednike.

Primjeri

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';
    }
  });
}

Rezultat

released

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori