v0.1.0 — Alpha · RGAA 4.1

L'accessibilité numérique expliquée,
page par page

RGAA = Référentiel Général d'Amélioration de l'Accessibilité (standard français). Un pré-audit open-source pour comprendre où agir en priorité, sans jargon inutile. Vous voyez ce qui est vérifié automatiquement, ce qui reste manuel, et pourquoi.

↓ Installer maintenant Star sur GitHub 
$ node bin/rgaa-audit.js https://mon-site.fr -o json -s rapport-home.json --vulgarized-save rapport-home-vulgarise.html
♿  RGAA Audit CLI v0.1.0
🌐 Chargement de la page…
⌨️  Simulation navigation clavier (15 éléments)…
🔍 Audit DOM — 13 thèmes RGAA 4.1…
🧾 Génération du rapport vulgarisé…
Taux de conformité : 89% 
Conformes : 17 Non conformes : 2
📁 Rapport sauvegardé : rapport.json
📄 Rapport vulgarisé sauvegardé : rapport-vulgarise.html

106

Règles d'accessibilité (RGAA 4.1)

26.4%

Automatisés aujourd'hui

14.2%

Partiels (à confirmer)

38.7%

Manuels uniquement

Nouveautés récentes (19 avril 2026)

Documentation synchronisée avec les commandes et la couverture actuelle du projet.

  • Statistiques alignées sur le mapping RGAA officiel du repo (`docs/RGAA-mapping.md`).
  • Parcours CLI clarifié: audit simple, multipages, export ODS et comparaison CLI vs extension.
  • Options avancées mises en avant: `--output-dir`, `--dom-only`, `--safe-crawl`, `--strict-security`.

Fonctionnalités

Tout ce qu'il faut pour
commencer à auditer

Un outil pensé pour passer de “je ne sais pas par où commencer” à un plan d'action concret.

Extension Chrome

Audit en contexte directement dans votre navigateur, pour comprendre rapidement les points bloquants d'une page.

CLI Playwright

Audit automatisé sur une ou plusieurs pages, intégrable en CI/CD, avec rapports exploitables par les équipes produit et dev.

Simulation humaine

Navigation clavier, zoom 200%, test sans CSS, viewport 320px: les usages réels sont simulés, pas seulement la structure HTML.

100% local

L'audit s'exécute sur votre machine. Pas de transfert de données à un tiers pendant l'audit standard.

Transparence du modèle

Code open-source, logique de contrôle lisible, couverture détaillée par critère: vous savez ce que l'outil sait faire et ne sait pas faire.

Fonctionnement

Comment lire un
pré-audit d'accessibilité (RGAA)

Chaque étape sert à objectiver un risque. Le rapport aide à prioriser, pas à certifier. Le temps d'audit varie selon le nombre de pages.

  1. Chargement de la page

    Avec attente de stabilisation du DOM — compatible avec les SPA React/Vue/Angular.

  2. Audit DOM automatique

    13 thèmes d'accessibilité scannés (référentiel RGAA) : images, couleurs, structure, formulaires, navigation…

  3. Navigation clavier (Tab ×15)

    Chaque élément focusé est analysé — outline CSS, visibilité, ordre de tabulation.

  4. Zoom 200% + sans CSS

    Détection de débordements, vérification de la lisibilité sans feuilles de style.

  5. Test responsive 320px

    Redimensionnement à 320px de large — standard mobile WCAG.

  6. Screenshots automatiques

    Captures à chaque étape clé pour documenter l'audit.

  7. Calcul du taux de conformité

    Indicateur de progression: il aide à comparer, mais ne remplace pas un audit de conformité officiel.

  8. Rapport actionnable

    Sortie JSON/HTML/CSV + rapport vulgarisé avec priorités, impacts utilisateurs et pistes de correction.

Couverture des règles d'accessibilité

Ce que l'outil vérifie,
et ce qu'il ne peut pas certifier

Pour le grand public, le plus important est de savoir comment lire le résultat: aide au diagnostic, pas verdict légal.

Détail complet par règle : RGAA-mapping.md.

Cette transparence permet de savoir exactement comment interpréter les résultats.

Pour une version pédagogique, consultez aussi le guide des règles d'accessibilité (RGAA).

✅ Vérifié automatiquement

L'outil repère des points techniques fréquents: structure HTML, labels, contrastes, navigation clavier de base.

  • Utile pour gagner du temps rapidement
  • Donne des priorités concrètes de correction

⚠️ À confirmer humainement

Certains signaux sont détectés, mais leur conformité dépend du contexte réel d'usage.

  • Exemple: pertinence d'un texte alternatif
  • Exemple: qualité d'une aide de formulaire

❌ Nécessairement manuel

Une partie des règles d'accessibilité (RGAA) nécessite un jugement humain, des tests d'usage et parfois des technologies d'assistance.

  • Le pré-audit ne remplace pas un audit certifié
  • Il sert de point de départ fiable pour agir

Installation

Commandes simples,
rapports immédiats

Parcours CLI recommandé: home page, multipages, export ODS, puis comparaison CLI vs extension.

CLI (recommandé)

Audit automatisé, CI/CD, rapports + vulgarisation

git clone https://github.com/Stan69000/rgaa-audit
cd rgaa-audit/cli
npm install
npx playwright install chromium
# 1) Rapport home page
node bin/rgaa-audit.js https://mon-site.fr -o json -s ./rapport-home.json --vulgarized-save ./rapport-home-vulgarise.html
# 2) Rapport multi-pages
node bin/rgaa-audit.js https://mon-site.fr --depth 8 -o json -s ./rapport-multipages.json --vulgarized-save ./rapport-multipages-vulgarise.html
# 3) Export grille ODS pré-remplie
node bin/rgaa-audit.js https://mon-site.fr -d 8 --ods-template ./grille.ods --ods-save ./grille-remplie.ods
# 4) Comparer CLI vs extension
node bin/rgaa-compare-reports.js ./cli-report.json ./extension-report.json --json
# Options utiles: --output-dir --dom-only --safe-crawl --strict-security

Extension Chrome (publiée)

Disponible sur le Chrome Web Store

# Installer l'extension publiée :
Chrome Web Store — RGAA Audit