CKTIS / JavaScript
Element.releasePointerCapture() — Pointer-Capture freigeben
releasePointerCapture(pointerId) gibt die Erfassung eines bestimmten Pointers durch ein Element frei und stellt die normale, positionsbasierte Ereigniszielbestimmung wieder her.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
element.releasePointerCapture(pointerId)Element.releasePointerCapture gibt die Erfassung des durch pointerId bezeichneten Pointers frei. Die ID stammt normalerweise aus einem Ereignis. Die Methode gibt undefined zurück. Durch die Erfassung werden Ereignisse auch außerhalb der Elementgrenzen an dieses Element geleitet; nach der Freigabe gilt wieder die normale, positionsbasierte Zielbestimmung. Physischer Kontakt oder ein Tastendruck werden dadurch nicht beendet.
Eine inaktive ID löst eine DOMException mit dem Namen NotFoundError aus. Bei einem aktiven Pointer hat die Methode keine Wirkung, wenn dieses Element ihn nicht erfasst hat. hasPointerCapture(pointerId) prüft den ausstehenden Erfassungsstatus. Die Freigabe löscht diesen Status sofort, doch lostpointercapture muss nicht synchron ausgelöst werden.
Der Browser gibt die Erfassung auch nach pointerup oder pointercancel frei. Das Beispiel gibt sie früher frei, bei der ersten Bewegung nach dem Drücken. Dies ist eine browserbasierte Pointer-Events-API und keine ECMAScript-Funktion; Node 24 belegt nicht, dass sie verfügbar ist. Prüfen Sie die Unterstützung in den Zielbrowsern.
Beispiele
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));
}
});Ergebnis
undefined false
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.