agentsclimarketplace

Rgaa dev

Skill Isalafont/claude-skill-rgaa-dev/skills/rgaa-dev

Accessibilité numérique (a11y) — RGAA 4.1.2 / WCAG 2.2 AA / WAI-ARIA 1.2. Invoquer quand le code concerne : HTML sémantique, ARIA, formulaires (label, erreur, autocomplete, stepper), liens, navigation, composants interactifs (modale, onglets, accordéon, dropdown, tooltip, upload, combobox), ViewComponent, Stimulus, Turbo, ERB, contraste, couleurs, focus clavier, lecteur d'écran, screen reader, axe-core, zoom 200%, target size, RGAA, WCAG, ARIA, a11y, handicap, accessibility. Fonctionne avec ou sans DSFR (détection automatique dans le projet).From its SKILL.md

Install
npx -y skills add Isalafont/claude-skill-rgaa-dev --skill rgaa-dev

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
  • 4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

9.4 KB, as published. Nobody here has run it

Accessibilité Numérique — Guide RGAA / WCAG / ARIA

Versions couvertes : RGAA 4.1.2 · WCAG 2.2 (AA) · DSFR 1.x · WAI-ARIA 1.2 Dernière mise à jour : avril 2026


Navigation : utiliser des Read ciblés (offset/limit). Ne pas faire de grep exploratoire — les tableaux de ce fichier font foi sur les sections à consulter.

Détection du contexte projet

Avant de produire du code, détecter si le projet utilise le DSFR :

  1. Rechercher des classes fr-* dans app/views/** ou app/components/**
  2. Vérifier package.json pour @gouvfr/dsfr
  3. Vérifier Gemfile pour DSFRFormBuilder

DSFR détecté → utiliser examples-dsfr.md et les classes fr-* / fr-sr-only. DSFR absent → utiliser examples-html.md et la classe .sr-only (CSS custom). En cas de doute, demander à l'utilisateur.


Quel fichier lire selon la tâche

TâcheFichiers à consulter
Créer/modifier un formulairergaa-themes.md §Formulaires + examples-dsfr.md §Formulaires + rails-patterns.md §DSFRFormBuilder
Créer un composant interactif (modale, onglets, accordéon, tooltip, combobox)examples-dsfr.md + examples-html.md §ARIA + rails-patterns.md §Stimulus
Formulaire multi-étapes (stepper)examples-dsfr.md §Stepper + rails-patterns.md §Redundant Entry
Créer/modifier de la navigation ou des liensrgaa-themes.md §Navigation + examples-dsfr.md §Liens
Tableau triable / filtrableexamples-dsfr.md §Tableau triable + rails-patterns.md
Liste filtrée / recherche dynamique (annonce de résultats, live region)examples-dsfr.md §Filtrage dynamique (+ §Champ de recherche avec suggestions si autocomplete)
Auditer ou faire la review d'une pagechecklist.md du type de page + html-structure.md §Outils
Travailler avec Turbo / Hotwirerails-patterns.md §Turbo
Question sur contrastes, target size, focuscolors.md
Question sur upload de fichiersexamples-dsfr.md §Upload
Comprendre l'impact d'un défautimpacts.md
Critères RGAA par thème avec exemplesrgaa-themes.md
(si DSFR) Règles spécifiques composants DSFRexamples-dsfr.md §Règles DSFR
Composant tiers, PDF, vidéo, charge disproportionnéefallbacks.md
Ressources, outils, déclarationresources.md

Workflow quotidien — accessibility-first

Applique l'accessibilité pendant l'implémentation, pas après :

  1. Structure HTML sémantique d'abord — titres, landmarks, listes, éléments natifs
  2. Attributs ARIA sur les éléments interactifs — aria-expanded, aria-controls, labels
  3. Checklist du type de page avant le commit — checklist.md
  4. Test clavier rapide — Tab, Shift+Tab, Enter, Escape, flèches dans les composants
  5. Test zoom 200% — Cmd++ × 6, vérifier qu'aucun contenu n'est coupé
  6. axe-core en CI — les steps Cucumber Then la page est accessible détectent les régressions

Contexte légal

Le RGAA 4.1.2 est le standard légal français basé sur WCAG 2.2 du W3C. Il s'applique à tous les services publics numériques (loi 2005-102, décret 2019-768). L'European Accessibility Act (EAA) rend WCAG 2.2 AA obligatoire dans l'UE depuis le 28 juin 2025.

Non-conformité = exclusion réelle :

  • Cécité / malvoyance → lecteurs d'écran (NVDA, JAWS, VoiceOver)
  • Motricité réduite → navigation clavier uniquement
  • Surdité → sous-titres, transcriptions
  • Troubles cognitifs → clarté, structure, prévisibilité

Règles d'or

  1. Tout élément interactif est accessible au clavier (Tab, Enter, Espace, flèches)
  2. Tout contenu non-textuel a un équivalent textuel (alt, aria-label, aria-labelledby)
  3. Le focus est toujours visible et non masqué (ne jamais faire outline: none sans alternative, et ne pas masquer avec un header sticky)
  4. Les couleurs ne sont pas le seul vecteur d'information (contraste ≥ 4.5:1, target size ≥ 24×24px)
  5. La structure sémantique est correcte (titres hiérarchiques, landmarks, listes)
  6. Les formulaires sont labellisés (<label for> ou aria-labelledby)
  7. Les erreurs sont identifiées et suggèrent une correction
  8. Le contenu peut être agrandi à 200% sans perte d'information (RGAA 10.4)

Règles des 5 ARIA (W3C)

  1. Utiliser le HTML natif en premier — pas d'ARIA si un élément sémantique natif existe
  2. Ne pas modifier la sémantique native inutilement
  3. Tous les contrôles ARIA doivent être utilisables au clavier
  4. Les éléments focusables ont un rôle, état et propriété visibles
  5. Les éléments interactifs ont un nom accessible

Anti-patterns ARIA — À ne jamais faire

<!-- ❌ tabindex > 0 : casse l'ordre naturel de navigation -->
<button tabindex="3">Soumettre</button>

<!-- ❌ <div> cliquable : pas de rôle, pas de clavier -->
<div onclick="submit()">Envoyer</div>
<!-- ✅ --> <button type="button">Envoyer</button>

<!-- ❌ aria-label ≠ texte visible (viole WCAG 2.5.3 Label in Name) -->
<button aria-label="Supprimer">Enlever</button>
<!-- ✅ aria-label doit contenir le texte visible -->
<button aria-label="Supprimer le fichier rapport.pdf">Supprimer</button>

<!-- ❌ role="presentation" sur élément interactif -->
<button role="presentation">Valider</button>

<!-- ❌ role="alert" + aria-live="assertive" : redondant -->
<div role="alert" aria-live="assertive">Erreur</div>
<!-- ✅ role="alert" implique déjà aria-live="assertive" -->
<div role="alert">Erreur</div>

Patterns ARIA essentiels

PatternRoleStates/Properties clés
Bouton togglebuttonaria-expanded, aria-controls
Menu déroulantmenu, menuitemaria-haspopup, aria-expanded
Ongletstablist, tab, tabpanelaria-selected, aria-controls
Accordéonbuttonaria-expanded, aria-controls
Modaldialogaria-modal, aria-labelledby
Alertealertaria-live="assertive" implicite
Statutstatusaria-live="polite" implicite
Comboboxcomboboxaria-expanded, aria-autocomplete, aria-activedescendant
Barre de progressionprogressbararia-valuenow, aria-valuemin, aria-valuemax
Tooltiptooltiparia-describedby
Stepperprogressbar ou navaria-current="step", aria-valuenow

Référence complète : https://www.w3.org/WAI/ARIA/apg/


Navigation clavier — Comportements attendus

ToucheComportement
TabPasser au prochain élément focusable
Shift+TabÉlément focusable précédent
EnterActiver lien/bouton
EspaceActiver bouton/checkbox
FlèchesNaviguer dans composants (menu, tabs, select, combobox)
EscapeFermer modal/menu/tooltip
Home/EndPremier/dernier élément d'une liste

Piège à focus : Les modales doivent piéger le focus (tab cycle dans la modale). Voir examples-html.md §Modale.


Texte pour lecteurs d'écran uniquement

/* DSFR : fr-sr-only  |  Universel : .sr-only */
.sr-only, .fr-sr-only {
  position: absolute;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip: rect(0, 0, 0, 0);
  white-space: nowrap;
  border: 0;
}
<!-- Utilisation : compléter un intitulé ambigu -->
<button>
  <span aria-hidden="true">✕</span>
  <span class="fr-sr-only">Fermer la modale</span>
</button>

Fichiers de ce skill

FichierContenu
rgaa-themes.mdCritères RGAA par thème avec exemples de code
examples-dsfr.mdExemples HTML+DSFR + règles spécifiques DSFR
examples-html.mdRéférence universelle HTML/WCAG/ARIA sans framework
checklist.mdChecklists par type de page + zoom + text spacing
rails-patterns.mdERB, DSFRFormBuilder, ViewComponent, Stimulus, Turbo, axe-core
colors.mdContrastes, target size, focus, tokens DSFR, outils
fallbacks.mdAlternatives quand l'idéal est impossible — charge disproportionnée, PDF, vidéo, composants tiers
html-structure.mdTitres, landmarks, erreurs Rails fréquentes, DevTools
resources.mdLiens RGAA/WCAG 2.2/ARIA, outils, déclaration
impacts.mdImpact des défauts par type de handicap

Keep looking

Skills are one crate of 610,045. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.