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

CKTIS / JavaScript

Element.releasePointerCapture() — sprostitev zajema kazalca

releasePointerCapture(pointerId) sprosti zajem določenega kazalca s strani elementa in znova vzpostavi običajno določanje cilja dogodkov glede na položaj.

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.releasePointerCapture(pointerId)

Element.releasePointerCapture sprosti zajem kazalca, označenega z pointerId, ki je običajno pridobljen iz dogodka. Metoda vrne undefined. Zajem usmerja dogodke v element tudi zunaj njegovih meja; po sprostitvi se znova vzpostavi običajno določanje cilja glede na položaj. S tem se ne konča fizični stik ali pritisk gumba.

Neaktiven identifikator povzroči DOMException z imenom NotFoundError. Pri aktivnem kazalcu metoda ne naredi ničesar, če ga ta element ne zajema. hasPointerCapture(pointerId) preveri čakajoče stanje zajema; sprostitev to stanje takoj izbriše, vendar se dogodek lostpointercapture ne sproži nujno sinhrono.

Brskalnik sprosti zajem tudi po dogodku pointerup ali pointercancel. Primer ga sprosti prej, ob prvem premiku po pritisku. To je brskalniški API Pointer Events in ne funkcija ECMAScript; Node 24 ne dokazuje, da je na voljo. Preverite podporo v ciljnih brskalnikih.

Primeri

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

Rezultat

undefined false

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

Viri