CKTIS / JavaScript
Element.setPointerCapture — een aanwijzer vastleggen
De methode setPointerCapture(pointerId) stuurt volgende gebeurtenissen van één bepaalde aanwijzer naar een gekozen element, ook wanneer de aanwijzer de grenzen ervan verlaat. Dit maakt slepen met een muis, aanraking of pen eenvoudiger.
Versie: 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.setPointerCapture(pointerId)Roep Element.setPointerCapture aan op een element, meestal in een pointerdown-handler, en geef event.pointerId mee. De vastlegging vervangt de normale doelkeuze op basis van de positie, zodat het element bijvoorbeeld pointermove-gebeurtenissen blijft ontvangen buiten zijn grenzen. De methode retourneert undefined; ze verplaatst of vergrendelt de cursor niet.
De aanroep stelt een wachtende vastlegging in: hasPointerCapture(pointerId) kan onmiddellijk true retourneren, nog vóór gotpointercapture. releasePointerCapture(pointerId) geeft de vastlegging expliciet vrij; na pointerup of pointercancel doet de browser dat automatisch. Gebruik lostpointercapture om de interactiestatus op te ruimen. Aanraakinvoer kan al impliciet zijn vastgelegd.
Een ID die niet overeenkomt met een actieve aanwijzer veroorzaakt NotFoundError. Een losgekoppeld element of een actieve Pointer Lock in het document ervan veroorzaakt InvalidStateError. Pas als de controles van de aanwijzer-ID, de verbondenheid van het element en de status van Pointer Lock zijn geslaagd, controleert de methode de overige voorwaarden: als er geen knop is ingedrukt en er geen contact is, of als het document van het element niet het actieve document van de aanwijzer is, stelt de methode geen vastlegging in en treedt er geen fout op.
Vastlegging schakelt scrollen of zoomen met aanraking niet uit; het voorbeeld gebruikt touch-action: none alleen voor het demonstratiegebied. Dit is een browser-API uit de Pointer Events-specificatie, geen functie van een bepaalde ECMAScript-editie. De aanwezigheid van Node 24 bewijst niet dat de API beschikbaar is: controleer de methode en test de doelbrowsers.
Voorbeelden
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';
}
});
}Resultaat
released
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.