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.