Ce que nous visons, comment chaque composant se pilote au clavier, ce qu’un lecteur d’écran annonce, et ce que nos tests vérifient vraiment, sans rien promettre de plus.
Le niveau AA est une cible, pas une certification.
Nous visons le niveau AA dans les deux thèmes, clair et sombre. Un composant qui atteint la cible dans un thème et pas dans l’autre n’est pas considéré comme conforme.
Pour vérifier un écran dans les deux thèmes, forcez-les tour à tour sur la racine du document.
La page Thèmes décrit les jetons de couleur et leur réglage.
<!-- À vérifier dans les deux thèmes : light, puis dark -->
<html lang="fr-CA" data-theme="dark">Tout ce qui se fait au pointeur se fait aussi au clavier.
Les composants s’appuient sur les éléments natifs et, pour les contrôles composés, sur les motifs de l’APG. L’ordre de tabulation suit l’ordre de lecture.
Tab et Maj+Tab : passer d’un contrôle au suivant ou au précédent.Entrée ou Espace : activer un bouton.Début et Fin : se déplacer dans un groupe à un seul arrêt de tabulation, comme les onglets de bythium-tabs, un menu ou une barre d’outils.Échap : fermer un dialogue, un menu ou une infobulle ; le focus revient à l’élément qui l’a ouvert.⌘K ou Ctrl+K : ouvrir la palette de recherche du site.Le bouton ci-dessous est un bouton natif : il reçoit le focus et s’active au clavier dans les quatre formats, sans code supplémentaire.
<!-- Tab pour l’atteindre, Entrée ou Espace pour l’activer -->
<bythium-button variant="primary">
Enregistrer
</bythium-button>Note
Un lien d’évitement, premier arrêt de tabulation de la page, permet de sauter la navigation : le composant bythium-skip-nav le fournit.
Chaque composant expose un rôle, un nom et un état. Le nom vient du texte visible quand il existe, sinon d’un attribut comme label.
À vérifier
Le comportement annoncé dépend du lecteur d’écran et du navigateur. Essayez vos écrans avec les outils que vos utilisateurs emploient vraiment : aucun test automatique ne remplace cette écoute.
Une liste honnête : ce qu’une machine constate, et ce qu’elle ne constate pas.
Sans pointeur, atteignez et activez chaque contrôle avec Tab, Entrée, Espace et les flèches. Le focus doit rester visible et ne jamais se perdre.
Relisez la page avec data-theme="light", puis avec data-theme="dark" : le texte, les contours et le focus doivent rester lisibles dans les deux.
Avec un lecteur d’écran, vérifiez que chaque contrôle annonce son nom, son rôle et son état, et que les messages d’état sont lus.
Messages en anglais
Le validateur répond en anglais aujourd’hui : ses messages de diagnostic ne sont pas traduits en français.
Un composant vous bloque au clavier ou s’annonce mal ? Décrivez le composant, le thème, le navigateur et la technologie d’assistance utilisés, puis proposez une correction dans le dépôt source.
Page de maquette, contenu cible.Proposer une modification