Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Element.setPointerCapture — zachycení ukazatele

Metoda setPointerCapture(pointerId) směruje další události konkrétního ukazatele na zvolený prvek, i když ukazatel opustí jeho hranice. Usnadňuje přetahování myší, dotykem nebo perem.

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

Syntaxe

element.setPointerCapture(pointerId)

Zavolejte Element.setPointerCapture na prvku, obvykle v obsluze pointerdown, a předejte event.pointerId. Zachycení nahrazuje běžný výběr cíle podle polohy, takže prvek dál přijímá například události pointermove i mimo své hranice. Metoda vrací undefined; kurzor nepřesouvá ani nezamyká.

Volání nastaví čekající zachycení: hasPointerCapture(pointerId) může okamžitě vrátit true, ještě před událostí gotpointercapture. releasePointerCapture(pointerId) zachycení výslovně uvolní; po pointerup nebo pointercancel ho prohlížeč uvolní automaticky. Událost lostpointercapture použijte k vyčištění stavu interakce. Dotykový vstup už může mít implicitní zachycení.

Identifikátor, který neodpovídá žádnému aktivnímu ukazateli, vyvolá NotFoundError. Odpojený prvek nebo aktivní Pointer Lock v jeho dokumentu vyvolá InvalidStateError. Teprve po úspěšné kontrole identifikátoru ukazatele, připojení prvku a stavu Pointer Lock metoda posoudí zbývající podmínky: pokud není stisknuté žádné tlačítko ani nedochází ke kontaktu nebo pokud dokument prvku není aktivním dokumentem ukazatele, metoda zachycení nenastaví a nevyvolá chybu.

Zachycení nevypíná posouvání ani přibližování dotykem; příklad používá touch-action: none pouze v demonstrační oblasti. Jde o API prohlížeče popsané ve specifikaci Pointer Events, nikoli o funkci určité edice ECMAScript. Samotná přítomnost Node 24 nedokazuje dostupnost: ověřte metodu a otestujte cílové prohlížeče.

Pří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ýsledek

released

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje