Déclaration d’accessibilité

Cette déclaration porte sur surea11y.dev, le site que vous lisez en ce moment, et non sur les résultats d’accessibilité que renvoie une analyse de votre propre site, traités dans la section Conformité.

Objectif de conformité

Ce site vise la conformité au niveau AA des WCAG 2.2. Il suit les mêmes règles de marque que toutes les interfaces des produits SureA11y : la couleur n’est jamais le seul repère (les indicateurs d’état et d’élément actif associent toujours la couleur à un second signal, qu’il s’agisse d’un soulignement, d’un glyphe ou d’un mot), chaque contrôle interactif a un contour de focus visible et une cible d’au moins 44 px, et chaque icône qui n’est pas purement décorative a une alternative textuelle.

Comment ce site est testé

Ce site est construit par l’équipe qui développe @surea11y/core : ce serait un drôle d’endroit pour se passer de notre propre moteur. Chaque modification est analysée avec @surea11y/core lui-même, dans un vrai navigateur (Chromium, via @surea11y/playwright), selon les WCAG 2.2 AA, à 375 et 1280 px de large, et rien n’est déployé tant que cette analyse signale un fail. Chaque vrai problème relevé est corrigé, pas justifié. Cette analyse a ses propres limites, assumées (voir Limites connues) : elle voit un seul état de chaque page, à ces deux largeurs, et ce qu’elle ne peut pas trancher, elle le signale en cantTell pour qu’une personne le vérifie.

L’analyse automatisée n’est qu’un plancher, jamais un plafond : ce n’est donc pas la seule vérification que reçoit ce site. Les modifications font aussi l’objet de tests d’accessibilité manuels : navigation au clavier seul, un passage avec un lecteur d’écran, et une vérification des points qu’aucun outil automatisé ne peut juger (un titre décrit-il vraiment ce qui suit, l’ordre du focus correspond-il à l’ordre visuel, un contenu qui n’apparaît qu’après une interaction reste-t-il atteignable). C’est la même position, « les outils automatisés ne peuvent pas tout vous dire », sur laquelle repose tout ce projet.

Lacunes connues

• La table des matières « Sur cette page » ne met pas en évidence votre position de défilement actuelle : il faudrait pour cela du JavaScript côté client, et ce site n’en utilise aucun, par choix. Les liens eux-mêmes fonctionnent normalement au clavier ou avec un lecteur d’écran ; seule la mise en évidence « vous êtes ici » pendant le défilement est absente.
• Les exemples de code sont volontairement affichés sur fond sombre alors que le reste du site est clair : c’est l’exception « un terminal reste un terminal » documentée dans le design system du site. Si cette combinaison de contraste vous est difficile à lire, le texte de chaque exemple de code reste entièrement sélectionnable et copiable en texte brut.

Signaler un problème

Si un élément de ce site est difficile à utiliser au clavier, avec un lecteur d’écran ou toute autre technologie d’assistance, merci d’ouvrir une issue sur GitHub. Indiquez l’URL de la page, ce que vous essayiez de faire et ce qui s’est passé à la place : le même niveau de détail que celui que vous attendriez de quiconque signale un bug dans le moteur lui-même.