# Cancelación del puntero: actuar al soltar, no al pulsar

Source: https://allyway.ai/es/glossary/cancelacion-del-puntero

Cancelación del puntero es el criterio de conformidad 2.5.2 de las WCAG (nivel A). En las funciones que se manejan con un único puntero, el evento de pulsación no activa la función, o la finalización en el evento de soltar puede abortarse o deshacerse, o el evento de soltar revierte el resultado, salvo que la pulsación sea esencial.

La cancelación del puntero es la oportunidad de rectificar tras pulsar el botón equivocado: pulsa, se da cuenta del error, desliza el dedo o el ratón fuera del botón y suelta, y no ocurre nada. El criterio WCAG 2.5.2 protege esa oportunidad al exigir que las acciones se ejecuten cuando se suelta el puntero, no en el instante en que toca el elemento. Así se evitan compras, eliminaciones y cambios de página accidentales.

## Qué significa

El criterio [WCAG 2.5.2 Cancelación del puntero](https://www.w3.org/WAI/WCAG22/Understanding/pointer-cancellation.html) es de nivel A. En la funcionalidad que se puede manejar con un único puntero, se cumple al menos una de estas cuatro condiciones:

| Condición | Significado |
|---|---|
| Sin evento de pulsación | El evento de pulsación (por ejemplo `mousedown`, `touchstart`) no ejecuta ninguna parte de la función |
| Abortar o deshacer | La función se completa en el evento de soltar (`mouseup`, `touchend`, `click`) y existe una forma de abortarla antes de completarse o de deshacerla después |
| Reversión al soltar | El evento de soltar revierte cualquier resultado del evento de pulsación anterior |
| Esencial | Completar la función en el evento de pulsación es esencial |

Las funciones que emulan la pulsación de una tecla de un teclado o de un teclado numérico se consideran esenciales, de modo que un piano o un teclado en pantalla puede reaccionar al pulsar. La norma abarca el contenido que interpreta acciones del puntero, no los controles del navegador ni de las tecnologías de apoyo.

El W3C indica el beneficio: todas las personas pueden recuperarse de un error al pulsar el objetivo equivocado, y quienes tienen una discapacidad visual, motora o cognitiva activan menos acciones por accidente y se desorientan menos ante cambios de contexto inesperados.

> **Tip:** > **Los controles nativos ya lo hacen bien**
> Un `<button>` o un enlace lanza su evento `click` al soltar, y solo si el puntero sigue sobre él. Si usa estos elementos y el evento `click`, cumple el criterio 2.5.2 sin trabajo adicional. Los problemas empiezan con los controladores personalizados de `mousedown` o `touchstart`.

## Ejemplos

```html title="Ejemplo"
<!-- Bad: the order is placed the moment the button is pressed -->
<div role="button" tabindex="0" onmousedown="placeOrder()">Buy now</div>

<!-- Good: a native button reacts on release, sliding off cancels -->
<button type="button" onclick="placeOrder()">Buy now</button>

<!-- Good: press and hold to preview, releasing hides it again (up reversal) -->
<button type="button" id="peek">Show password</button>
<script>
  const peek = document.getElementById('peek');
  peek.addEventListener('pointerdown', () => showPassword(true));
  peek.addEventListener('pointerup', () => showPassword(false));
  peek.addEventListener('pointerleave', () => showPassword(false));
</script>
```

La vista previa al mantener pulsado sigue un ejemplo del W3C: lo que aparece al pulsar desaparece de nuevo al soltar. En el arrastrar y soltar, el W3C muestra la vía de aborto: un elemento soltado fuera de un destino válido vuelve a donde estaba. Encontrará más información en [movimientos de arrastre](https://allyway.ai/es/glossary/movimientos-de-arrastre).

**Do:** Qué hacer

Use botones y enlaces nativos con el evento `click`, haga que el arrastrar y soltar devuelva el elemento a su sitio si se suelta fuera de un destino, añada «Deshacer» en las acciones que no pueden esperar y dé a los botones un [tamaño del objetivo](https://allyway.ai/es/glossary/tamano-del-objetivo) suficiente para acertar a la primera.

**Don't:** Qué evitar

Activar compras, eliminaciones, navegación o el envío de formularios con `mousedown`, `touchstart` o `pointerdown`, o abrir un menú al pulsar que además selecciona el elemento que queda bajo el puntero.

## Cómo comprobar la cancelación del puntero



## Preguntas frecuentes

Q: ¿Cuál es la diferencia entre un evento de pulsación y un evento de soltar?
A: El evento de pulsación se produce cuando se pulsa el puntero, como `mousedown` o `touchstart`. El evento de soltar se produce cuando se suelta, como `mouseup` o `touchend`. El criterio WCAG 2.5.2 quiere que las funciones se completen en el evento de soltar.

Q: ¿Cumple el evento click el criterio WCAG 2.5.2?
A: Sí, en la práctica. El evento `click` de los botones y enlaces nativos se lanza al soltar y solo si el puntero sigue sobre el elemento, de modo que deslizarse fuera lo cancela.

Q: ¿Se permiten las acciones de mantener pulsado?
A: Sí, si soltar revierte lo que hizo pulsar; por ejemplo, una vista previa que se muestra mientras el puntero está pulsado y se oculta al soltar. El W3C lo llama reversión al soltar.

Q: ¿Cuándo puede una función activarse al pulsar?
A: Solo cuando es esencial, como en un teclado o un piano en pantalla que imita la pulsación de una tecla. El W3C considera esencial emular la pulsación de una tecla de un teclado o de un teclado numérico.
