Communitygithub.com

Accessibilité & WCAG

Modèles d'accessibilité web pour la conformité WCAG 2.2 incluant ARIA, navigation clavier, lecteurs d'écran et tests.

Qu'est-ce que Accessibilité & WCAG ?

Cette compétence fournit un ensemble complet de modèles et de bonnes pratiques pour rendre les applications web accessibles conformément aux normes WCAG 2.2. Elle couvre l'utilisation du HTML sémantique pour les points de repère, les motifs ARIA pour les composants dynamiques (modales, onglets), la navigation au clavier avec la gestion des touches fléchées, et l'accessibilité des formulaires avec des messages d'erreur annoncés aux lecteurs d'écran. Elle inclut également des recommandations sur les contrastes de couleurs (ratio 4.5:1 pour le texte normal) et une liste de contrôle pratique pour vérifier la conformité. L'ensemble est illustré par des exemples de code prêts à l'emploi en HTML, CSS et React (TypeScript), et met en garde contre les anti-patrons courants comme l'absence d'indicateurs de focus ou l'utilisation exclusive de la couleur pour transmettre une information.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SamuelChien/mega-skills-collection/tree/HEAD/accessibility-wcag

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait Accessibilité & WCAG ?

HTML Sémantique

<!-- Utilisez des éléments sémantiques au lieu de div génériques -->
<header>
  <nav aria-label="Navigation principale">
    <ul>
      <li><a href="/" aria-current="page">Accueil</a></li>
      <li><a href="/products">Produits</a></li>
      <li><a href="/about">À propos</a></li>
    </ul>
  </nav>
</header>

<main>
  <article>
    <h1>Détails du produit</h1>
    <section aria-labelledby="specs-heading">
      <h2 id="specs-heading">Spécifications</h2>
      <dl>
        <dt>Poids</dt>
        <dd>1,2 kg</dd>
        <dt>Dimensions</dt>
        <dd>30 x 20 x 10 cm</dd>
      </dl>
    </section>
  </article>
</main>

<footer>
  <p>&copy; 2024 Nom de l'entreprise</p>
</footer>

Utilisez <nav>, <main>, <article>, <section>, <aside> au lieu de <div> pour les points de repère. Les lecteurs d'écran utilisent ces éléments pour naviguer dans la page.

Motifs ARIA

function Modal({ isOpen, onClose, title, children }) {
  if (!isOpen) return null;

  return (
    <div
      role="dialog"
      aria-modal="true"
      aria-labelledby="modal-title"
      onKeyDown={(e) => e.key === "Escape" && onClose()}
    >
      <h2 id="modal-title">{title}</h2>
      <div>{children}</div>
      <button onClick={onClose} aria-label="Fermer la boîte de dialogue">
        <XIcon aria-hidden="true" />
      </button>
    </div>
  );
}

function Tabs({ tabs, activeIndex, onChange }) {
  return (
    <div>
      <div role="tablist" aria-label="Sections des paramètres">
        {tabs.map((tab, i) => (
          <button
            key={tab.id}
            role="tab"
            id={`tab-${tab.id}`}
            aria-selected={i === activeIndex}
            aria-controls={`panel-${tab.id}`}
            tabIndex={i === activeIndex ? 0 : -1}
            onClick={() => onChange(i)}
            onKeyDown={(e) => handleArrowKeys(e, i, tabs.length, onChange)}
          >
            {tab.label}
          </button>
        ))}
      </div>
      {tabs.map((tab, i) => (
        <div
          key={tab.id}
          role="tabpanel"
          id={`panel-${tab.id}`}
          aria-labelledby={`tab-${tab.id}`}
          hidden={i !== activeIndex}
          tabIndex={0}
        >
          {tab.content}
        </div>
      ))}
    </div>
  );
}

Navigation au Clavier

function handleArrowKeys(
  event: React.KeyboardEvent,
  currentIndex: number,
  totalItems: number,
  onSelect: (index: number) => void
) {
  let newIndex = currentIndex;

  switch (event.key) {
    case "ArrowRight":
    case "ArrowDown":
      newIndex = (currentIndex + 1) % totalItems;
      break;
    case "ArrowLeft":
    case "ArrowUp":
      newIndex = (currentIndex - 1 + totalItems) % totalItems;
      break;
    case "Home":
      newIndex = 0;
      break;
    case "End":
      newIndex = totalItems - 1;
      break;
    default:
      return;
  }

  event.preventDefault();
  onSelect(newIndex);
}

Tous les éléments interactifs doivent être accessibles via le clavier. Tab pour la navigation par focus, Entrée/Espace pour l'activation, touches fléchées pour la navigation au sein d'un composant.

Accessibilité des Formulaires

function SignupForm() {
  return (
    <form aria-labelledby="form-title" noValidate>
      <h2 id="form-title">Créer un compte</h2>

      <div>
        <label htmlFor="email">Adresse e-mail</label>
        <input
          id="email"
          type="email"
          required
          aria-required="true"
          aria-describedby="email-hint email-error"
          aria-invalid={hasError ? "true" : undefined}
        />
        <p id="email-hint">Nous ne partagerons jamais votre e-mail.</p>
        {hasError && (
          <p id="email-error" role="alert">
            Veuillez saisir une adresse e-mail valide.
          </p>
        )}
      </div>

      <button type="submit">Créer un compte</button>
    </form>
  );
}

Couleur et Contraste

:root {
  --text-primary: #1a1a1a;      /* 15,3:1 sur blanc */
  --text-secondary: #595959;    /* 7,0:1 sur blanc */
  --text-on-primary: #ffffff;   /* Assurer 4,5:1 sur la couleur de marque */
  --border-focus: #0066cc;      /* Anneau de focus visible */
}

*:focus-visible {
  outline: 3px solid var(--border-focus);
  outline-offset: 2px;
}

.error-message {
  color: #d32f2f;
  /* Ne pas se fier uniquement à la couleur - ajouter une icône ou un préfixe textuel */
}
.error-message::before {
  content: "Erreur : ";
  font-weight: bold;
}

WCAG AA exige un contraste de 4,5:1 pour le texte normal, 3:1 pour le texte de grande taille (18px gras ou 24px normal).

Anti-patrons

  • Utiliser div et span pour des éléments cliquables au lieu de button ou a
  • Supprimer les contours de focus sans fournir d'indicateur alternatif
  • Se fier uniquement à la couleur pour transmettre une information (rouge pour erreur, vert pour succès)
  • Utiliser aria-label alors qu'un texte visible étiquette déjà l'élément
  • Lire automatiquement des médias sans mécanisme de pause
  • Absence de lien de navigation pour sauter le contenu pour les utilisateurs clavier

Liste de Contrôle

  • Tous les éléments interactifs accessibles au clavier (Tab, Entrée, Échap, Flèches)
  • Points de repère HTML sémantiques utilisés (nav, main, article, section)
  • Les images ont un texte alt descriptif (ou alt="" pour les images décoratives)
  • Le contraste des couleurs respecte WCAG AA (4,5:1 texte normal, 3:1 texte grand)
  • Indicateurs de focus visibles sur tous les éléments interactifs
  • Les champs de formulaire sont associés à des éléments <label>
  • Les messages d'erreur sont annoncés aux lecteurs d'écran via role="alert"
  • Page testée avec un lecteur d'écran (VoiceOver, NVDA) et uniquement au clavier

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

SamuelChien/mega-skills-collection

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

SamuelChien/mega-skills-collection

Arquitecto de Soluciones Principal y Consultor Tecnológico de Andru.ia. Diagnostica y traza la hoja de ruta óptima para proyectos de IA en español.

SamuelChien/mega-skills-collection

Ingeniero de Sistemas de Andru.ia. Diseña, redacta y despliega nuevas habilidades (skills) dentro del repositorio siguiendo el Estándar de Diamante.

SamuelChien/mega-skills-collection

Estratega de Inteligencia de Dominio de Andru.ia. Analiza el nicho específico de un proyecto para inyectar conocimientos, regulaciones y estándares únicos del sector. Actívalo tras definir el nicho.

SamuelChien/mega-skills-collection

2D game development principles. Sprites, tilemaps, physics, camera.

SamuelChien/mega-skills-collection

3D game development principles. Rendering, shaders, physics, cameras.

SamuelChien/mega-skills-collection

Expert in building 3D experiences for the web - Three.js, React Three Fiber, Spline, WebGL, and interactive 3D scenes. Covers product configurators, 3D portfolios, immersive websites, and bringing depth to web experiences.

SamuelChien/mega-skills-collection

Accessibility audit skill for scanning, fixing, and verifying WCAG 2.2 Level A and AA compliance across React, Next.js, Vue, Angular, Svelte, and plain HTML codebases. Use when auditing accessibility, fixing a11y violations, checking color contrast, generating compliance reports, or integrating accessibility checks into CI/CD pipelines.

SamuelChien/mega-skills-collection

Ab Test Analyzer - Auto-activating skill for Data Analytics. Triggers on: ab test analyzer, ab test analyzer Part of the Data Analytics skill category.

SamuelChien/mega-skills-collection

A B Test Config Creator - Auto-activating skill for ML Deployment. Triggers on: a b test config creator, a b test config creator Part of the ML Deployment skill category.

SamuelChien/mega-skills-collection

When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "conversion experiment," "statistical significance," or "test this." For tracking implementation, see analytics-tracking.

SamuelChien/mega-skills-collection

Acceptance Criteria Creator - Auto-activating skill for Enterprise Workflows. Triggers on: acceptance criteria creator, acceptance criteria creator Part of the Enterprise Workflows skill category.

SamuelChien/mega-skills-collection

Use when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and acceptance verification with minimal human re-intervention.

SamuelChien/mega-skills-collection

Accessibility Audit Runner - Auto-activating skill for Frontend Development. Triggers on: accessibility audit runner, accessibility audit runner Part of the Frontend Development skill category.

SamuelChien/mega-skills-collection

You are an accessibility expert specializing in WCAG compliance, inclusive design, and assistive technology compatibility. Conduct audits, identify barriers, and provide remediation guidance.

SamuelChien/mega-skills-collection

Manage Discord channel access — approve pairings, edit allowlists, set DM/group policy. Use when the user asks to pair, approve someone, check who's allowed, or change policy for the Discord channel.

SamuelChien/mega-skills-collection

Create unified specification packages across Business, Development, and Design teams. Staged elaboration (L0 Vision → L1 Requirements → L2 Team Detail → L3 Acceptance Criteria) to build shared understanding. Does not write code.

SamuelChien/mega-skills-collection

Research a company or person and get actionable sales intel. Works standalone with web search, supercharged when you connect enrichment tools or your CRM. Trigger with "research [company]", "look up [person]", "intel on [prospect]", "who is [name] at [company]", or "tell me about [company]".

SamuelChien/mega-skills-collection

Create forensically sound bit-for-bit disk images using dd and dcfldd while preserving evidence integrity through hash verification.

SamuelChien/mega-skills-collection

Validate messaging consistency across website, GitHub repos, and local documentation generating read-only discrepancy reports. Use when checking content alignment or finding mixed messaging. Trigger with phrases like "check consistency", "validate documentation", or "audit messaging".

Skills associés