# Annulation de l’action du pointeur : agir au relâchement

Source: https://allyway.ai/fr/glossary/annulation-du-pointeur

L’annulation de l’action du pointeur est le critère de succès WCAG 2.5.2 (niveau A). Pour les fonctions commandées par un seul pointeur, l’événement d’appui ne déclenche pas la fonction, ou la fin de la fonction au relâchement peut être abandonnée ou annulée, ou le relâchement inverse le résultat, sauf si l’appui est essentiel.

L’annulation de l’action du pointeur, c’est la possibilité de changer d’avis après avoir appuyé sur le mauvais bouton : vous appuyez, vous voyez l’erreur, vous faites glisser le doigt ou la souris ailleurs et vous relâchez – et il ne se passe rien. Le critère WCAG 2.5.2 protège cette possibilité en demandant que les actions s’exécutent au relâchement du pointeur, et non à l’instant où il touche l’écran. Il évite les achats, les suppressions et les changements de page accidentels.

## Ce que cela signifie

Le critère [WCAG 2.5.2 Annulation de l’action du pointeur](https://www.w3.org/WAI/WCAG22/Understanding/pointer-cancellation.html) est de niveau A. Pour une fonction qui peut être commandée avec un seul pointeur, au moins une de ces quatre conditions est remplie :

| Condition | Signification |
|---|---|
| Pas d’événement d’appui | L’événement d’appui (par exemple `mousedown`, `touchstart`) n’exécute aucune partie de la fonction |
| Abandon ou annulation | La fonction se termine au relâchement (`mouseup`, `touchend`, `click`), et il est possible de l’abandonner avant la fin ou de l’annuler ensuite |
| Inversion au relâchement | Le relâchement inverse tout résultat de l’appui précédent |
| Essentiel | Terminer la fonction à l’appui est essentiel |

Les fonctions qui imitent l’appui sur une touche du clavier ou du pavé numérique sont considérées comme essentielles : un piano ou un clavier à l’écran peut donc réagir à l’appui. Le critère porte sur le contenu qui interprète les actions du pointeur, pas sur les commandes du navigateur ou de la technologie d’assistance.

Le W3C cite l’avantage : tous les utilisateurs peuvent se rattraper après avoir touché la mauvaise cible, et les personnes ayant une déficience visuelle, motrice ou cognitive déclenchent moins d’actions par accident – et sont moins désorientées par des changements de contexte inattendus.

> **Tip:** > **Les contrôles natifs font déjà ce qu’il faut**
> Un `<button>` ou un lien déclenche son événement `click` au relâchement, et seulement si le pointeur est encore dessus. Si vous utilisez ces éléments et l’événement `click`, vous satisfaites le critère 2.5.2 sans travail supplémentaire. Les problèmes commencent avec des gestionnaires `mousedown` ou `touchstart` personnalisés.

## Exemples

```html title="Exemple"
<!-- 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>
```

L’aperçu par appui prolongé suit un exemple du W3C : ce qui apparaît à l’appui disparaît au relâchement. Pour le glisser-déposer, le W3C montre la voie de l’abandon : un élément déposé en dehors d’une cible valide retourne à sa place. Pour en savoir plus, voir les [mouvements de glissement](https://allyway.ai/fr/glossary/mouvements-de-glissement).

**Do:** À faire

Utiliser des boutons et des liens natifs avec l’événement `click`, faire revenir l’élément à sa place quand il est relâché en dehors d’une cible, ajouter une option « Annuler » pour les actions qui ne peuvent pas attendre, et donner aux boutons une [taille de cible](https://allyway.ai/fr/glossary/taille-de-la-cible) suffisante pour les atteindre du premier coup.

**Don't:** À éviter

Déclencher un achat, une suppression, une navigation ou l’envoi d’un formulaire sur `mousedown`, `touchstart` ou `pointerdown`, ou ouvrir un menu à l’appui qui sélectionne aussi l’élément situé sous le pointeur.

## Comment vérifier l’annulation de l’action du pointeur



## Questions fréquentes

Q: Quelle est la différence entre un événement d’appui et un événement de relâchement ?
A: L’événement d’appui se produit quand le pointeur est enfoncé, comme `mousedown` ou `touchstart`. L’événement de relâchement se produit quand il est relâché, comme `mouseup` ou `touchend`. Le critère WCAG 2.5.2 veut que les fonctions se terminent au relâchement.

Q: L’événement click satisfait-il le critère WCAG 2.5.2 ?
A: Oui, en pratique. L’événement `click` des boutons et des liens natifs se déclenche au relâchement et seulement si le pointeur est encore sur l’élément : glisser ailleurs l’annule.

Q: Les actions par appui prolongé sont-elles autorisées ?
A: Oui, si le relâchement inverse ce que l’appui a fait – par exemple un aperçu qui s’affiche tant que le pointeur est enfoncé et se masque au relâchement. Le W3C appelle cela l’inversion au relâchement.

Q: Quand une fonction peut-elle se déclencher à l’appui ?
A: Seulement quand c’est essentiel, comme pour un clavier ou un piano à l’écran qui imite l’appui sur une touche. Le W3C considère comme essentiel le fait d’imiter l’appui sur une touche du clavier ou du pavé numérique.
