CKTIS / JavaScript
Element.setPointerCapture: capturar un puntero
El método setPointerCapture(pointerId) dirige los eventos posteriores de un puntero concreto a un elemento elegido, incluso cuando el puntero sale de sus límites. Facilita el arrastre con ratón, pantalla táctil o lápiz.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
element.setPointerCapture(pointerId)Llama a Element.setPointerCapture en un elemento, normalmente dentro de un manejador pointerdown, y pásale event.pointerId. La captura sustituye la selección normal del destino según la posición, por lo que el elemento sigue recibiendo eventos como pointermove aunque el puntero esté fuera de sus límites. El método devuelve undefined; no mueve ni bloquea el cursor.
La llamada establece una captura pendiente: hasPointerCapture(pointerId) puede devolver true inmediatamente, antes de que se produzca gotpointercapture. releasePointerCapture(pointerId) la libera explícitamente; después de pointerup o pointercancel, el navegador la libera automáticamente. Usa lostpointercapture para limpiar el estado de la interacción. La entrada táctil puede tener ya una captura implícita.
Un identificador que no corresponda a ningún puntero activo provoca NotFoundError. Un elemento desconectado o un Pointer Lock activo en su documento provoca InvalidStateError. Solo después de superar las comprobaciones del identificador del puntero, la conexión del elemento y el estado de Pointer Lock se evalúan las demás condiciones: si no hay ningún botón pulsado ni contacto, o si el documento del elemento no es el documento activo del puntero, el método no establece la captura ni genera un error.
La captura no desactiva el desplazamiento ni el zoom táctiles; el ejemplo usa touch-action: none solo en su zona de demostración. Esta es una API del navegador especificada por Pointer Events, no una función de una edición concreta de ECMAScript. Tener Node 24 no demuestra que esté disponible: comprueba el método y prueba los navegadores de destino.
Ejemplos
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';
}
});
}Resultado
released
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.