@rgaa-checker/eslint-plugin-rgaa

Règles ESLint d'accessibilité mappées au RGAA 4.1.2, en couche au-dessus de eslint-plugin-jsx-a11y. Chaque règle indique le critère RGAA visé et renvoie vers sa fiche.

Lint partiel, pas une preuve de conformité. Un linter statique ne couvre qu'une fraction du RGAA. D'après la méthodologie d'axe-core, ~60 % des critères WCAG restent à vérifier manuellement. Ce plugin aide à corriger tôt les erreurs détectables dans le code source ; pour le reste, lancez un scan complet RGAA Checker.

Installation

npm install -D @rgaa-checker/eslint-plugin-rgaa eslint-plugin-jsx-a11y eslint

Usage (ESLint 9, flat config)

Le plugin suppose un parseur compatible JSX déjà configuré dans votre projet (Next.js, typescript-eslint, etc.). Ajoutez la config recommandée à la suite de votre configuration existante :

// eslint.config.js
import rgaa from '@rgaa-checker/eslint-plugin-rgaa';

export default [
  // ...votre config qui établit le parseur JSX/TS (Next.js, typescript-eslint)...
  ...rgaa.configs.recommended,
];

rgaa.configs.recommended active les checks de jsx-a11y et les règles RGAA ci-dessous.

Pour n'activer que les règles RGAA (sans jsx-a11y) :

import rgaa from '@rgaa-checker/eslint-plugin-rgaa';

export default [
  {
    plugins: { rgaa },
    rules: {
      'rgaa/img-alt': 'error',
      'rgaa/no-noninteractive-onclick': 'error',
    },
  },
];

Règles

| Règle | Critère RGAA | Description | |-------|--------------|-------------| | rgaa/img-alt | 1.1 | Les images doivent avoir une alternative textuelle (alt). | | rgaa/no-noninteractive-onclick | 7.1 | Une action au clic doit être sur un <button> (ou <a> pour naviguer), pas un élément statique. |

D'autres critères seront ajoutés progressivement.

Licence

MPL-2.0