Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Element.setPointerCapture — zajem kazalca

Metoda setPointerCapture(pointerId) usmeri nadaljnje dogodke določenega kazalca na izbrani element, tudi ko kazalec zapusti njegove meje. Olajša vlečenje z miško, dotikom ali pisalom.

Različica: 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)

Pokličite Element.setPointerCapture na elementu, običajno v obravnavalniku pointerdown, in podajte event.pointerId. Zajem nadomesti običajno izbiro cilja glede na položaj, zato element še naprej prejema dogodke, kot je pointermove, tudi zunaj svojih meja. Metoda vrne undefined; kazalca ne premakne ali zaklene.

Klic nastavi čakajoči zajem: hasPointerCapture(pointerId) lahko takoj vrne true, še preden se sproži gotpointercapture. releasePointerCapture(pointerId) zajem izrecno sprosti; po pointerup ali pointercancel ga brskalnik sprosti samodejno. Za čiščenje stanja interakcije uporabite lostpointercapture. Vnos na dotik ima lahko že implicitni zajem.

Identifikator, ki ne ustreza nobenemu aktivnemu kazalcu, povzroči NotFoundError. Odklopljen element ali aktiven Pointer Lock v njegovem dokumentu povzroči InvalidStateError. Šele po uspešnem preverjanju identifikatorja kazalca, povezanosti elementa in stanja Pointer Lock metoda preveri preostale pogoje: če ni niti pritisnjenega gumba niti stika ali če dokument elementa ni aktivni dokument kazalca, metoda ne nastavi zajema in ne sproži napake.

Zajem ne izklopi drsenja ali povečave z dotikom; primer uporablja touch-action: none samo na predstavitvenem območju. To je brskalniški API iz specifikacije Pointer Events, ne funkcija določene izdaje ECMAScript. Prisotnost Node 24 sama po sebi ne dokazuje, da je API na voljo: preverite metodo in preizkusite ciljne brskalnike.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri