# Infobulle accessible : survol, focus et Échap

Source: https://allyway.ai/fr/glossary/infobulle-accessible

Une infobulle accessible est une petite fenêtre qui donne des informations complémentaires sur un élément. Elle s’affiche au survol de la souris et au focus clavier, est reliée à son déclencheur par aria-describedby et respecte le critère WCAG 1.4.13 Contenu au survol ou au focus, au niveau AA : elle peut être masquée, survolée et reste visible jusqu’à ce que l’utilisateur s’éloigne.

Une infobulle accessible est une petite bulle de texte qui explique un contrôle – « Copier le lien », « Obligatoire pour les factures », une aide à côté d’un champ de formulaire – et que tout le monde peut lire et refermer. Beaucoup d’infobulles ne s’ouvrent qu’au survol de la souris, disparaissent dès que le pointeur se dirige vers elles ou recouvrent le texte que les gens essaient de lire. Pour les utilisateurs du clavier, des loupes d’écran et des écrans tactiles, l’aide est alors inaccessible ou gênante.

## Ce que cela signifie

Les règles d’affichage viennent du critère [WCAG 1.4.13 Contenu au survol ou au focus](https://www.w3.org/WAI/WCAG22/Understanding/content-on-hover-or-focus.html) (niveau AA). Dès que le survol ou le focus clavier fait apparaître un contenu supplémentaire, trois conditions s’appliquent – elles sont détaillées à la page [contenu au survol ou au focus](https://allyway.ai/fr/glossary/contenu-au-survol-ou-au-focus) :

| Condition | Ce qu’elle exige |
|---|---|
| Masquable | L’utilisateur peut fermer l’infobulle sans déplacer le pointeur ni le focus, en général avec Échap – sauf si elle affiche une erreur de saisie ou ne recouvre aucun autre contenu |
| Survolable | Si le survol l’ouvre, le pointeur peut se déplacer sur l’infobulle sans qu’elle disparaisse |
| Persistant | Elle reste visible jusqu’à ce que le survol ou le focus la quitte, que l’utilisateur la masque ou que son information ne soit plus valide |

L’exception concerne les infobulles dont l’apparence est contrôlée par le navigateur et non modifiée par l’auteur. C’est pourquoi l’attribut natif `title` n’est pas couvert par le critère 1.4.13. Mais il ne s’affiche qu’au survol de la souris, pas au focus clavier ni au toucher, et il convient mal aux informations importantes.

Pour le code, le [modèle Tooltip](https://www.w3.org/WAI/ARIA/apg/patterns/tooltip/) du W3C en décrit les bases (il est encore signalé comme en cours d’élaboration) :

- la fenêtre a `role="tooltip"`
- le déclencheur la désigne avec `aria-describedby`, de sorte que les lecteurs d’écran la lisent comme une description
- le focus reste sur le déclencheur – une infobulle ne reçoit jamais le focus elle-même
- Échap la ferme

> **Note:** > **Une infobulle n’est pas un nom**
> Un bouton icône qui ne s’explique que par une infobulle a quand même besoin de son propre [nom accessible](https://allyway.ai/fr/glossary/nom-accessible), par exemple un `aria-label`. L’infobulle ajoute une description ; elle ne remplace pas l’étiquette.

## Exemples

```html title="Exemple"
<button type="button" aria-label="Copy link"
        aria-describedby="tip-copy">
  <svg aria-hidden="true" focusable="false">…</svg>
</button>
<div role="tooltip" id="tip-copy" hidden>
  Copies the address of this page to your clipboard
</div>
```

Le script affiche l’infobulle sur `mouseenter` et `focus`, la garde ouverte tant que le pointeur est sur le bouton ou sur l’infobulle, et la masque sur `mouseleave`, `blur` et Échap. Le [bouton icône](https://allyway.ai/fr/glossary/bouton-icone) a son propre nom, donc un lecteur d’écran annonce « Copy link, bouton, Copies the address of this page to your clipboard ».

**Do:** À faire

Ouvrir l’infobulle au survol et au focus clavier, laisser Échap la fermer, la garder ouverte tant que le pointeur est dessus, la placer de façon à ne pas recouvrir le déclencheur, rédiger un texte court.

**Don't:** À éviter

Mettre des consignes essentielles uniquement dans une infobulle, compter sur l’attribut `title` pour les utilisateurs du clavier ou du tactile, la fermer après un délai fixe, y ajouter des liens ou des boutons, utiliser une infobulle comme seul nom d’un bouton icône.

Pour un contenu avec des liens ou une explication plus longue, utilisez un toggletip – un petit bouton qui affiche l’aide au clic – ou affichez le texte directement dans la page.

## Comment vérifier une infobulle accessible



## Questions fréquentes

Q: Comment rendre une infobulle accessible ?
A: Affichez-la au survol et au focus clavier, reliez-la avec `aria-describedby`, donnez `role="tooltip"` à la fenêtre, fermez-la avec Échap et gardez-la ouverte tant que le pointeur est dessus. Les informations importantes doivent figurer dans la page, pas seulement dans une infobulle.

Q: L’attribut title est-il accessible ?
A: Il est en dehors du critère WCAG 1.4.13, car le navigateur contrôle son apparence. Mais il ne s’affiche qu’au survol de la souris, si bien que les utilisateurs du clavier et du tactile ne le voient généralement jamais. Ne l’utilisez pour rien d’essentiel.

Q: Une infobulle doit-elle se fermer avec Échap ?
A: Oui. Le critère WCAG 1.4.13 exige un moyen de masquer le contenu supplémentaire sans déplacer le pointeur ni le focus, et le modèle d’infobulle du W3C utilise Échap pour cela.

Q: Une infobulle peut-elle contenir des liens ou des boutons ?
A: Une infobulle ne reçoit jamais le focus, donc personne ne pourrait atteindre un contenu interactif placé dedans. Utilisez plutôt un toggletip ou une boîte de dialogue non modale.

Q: Comment fonctionnent les infobulles sur mobile ?
A: Les écrans tactiles n’ont pas de survol. Veillez à ce que l’information soit disponible autrement – sous forme de texte visible, ou derrière un bouton qui l’ouvre au toucher.
