Communitygithub.com

Auditeur d'Accessibilité

Examine les composants d'interface utilisateur pour la conformité WCAG, les attributs ARIA, la navigation au clavier et la prise en charge des lecteurs d'écran. À utiliser lors de la construction de composants frontaux ou lorsque les utilisateurs demandent des améliorations d'accessibilité.

Qu'est-ce que Auditeur d'Accessibilité ?

Cette compétence audite les applications web pour la conformité d'accessibilité (WCAG 2.1 Niveau AA) et propose des améliorations concrètes. Elle couvre la vérification de la sémantique HTML, l'utilisation correcte des attributs ARIA, la navigation au clavier, les textes alternatifs, le contraste des couleurs, les formulaires, la hiérarchie des titres, le contenu dynamique, et les tests automatisés. Elle est utile pour les développeurs frontend, les designers UI/UX et les équipes qualité lors de la construction ou de la revue de composants d'interface, ou en préparation d'audits d'accessibilité. La compétence inclut une checklist WCAG 2.1 AA, des exemples de code (HTML, JavaScript, CSS), des commandes CLI pour des outils comme Lighthouse, axe-core et pa11y, ainsi que des références aux fichiers d'accompagnement. Elle fonctionne sur n'importe quelle plateforme où un agent IA peut exécuter des commandes shell et analyser du code source. L'approche suit le principe de prioriser le HTML sémantique avant d'utiliser ARIA, et insiste sur les tests avec de vrais lecteurs d'écran et outils de simulation.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/crazydubya/accessibility-auditor

Demander à votre IA préférée

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

Aperçu

Depuis le README du skill

Auditeur d'Accessibilité preview
Auditeur d'Accessibilité preview
Auditeur d'Accessibilité preview

Documentation

Que fait Auditeur d'Accessibilité ?

Audite les applications web pour la conformité d'accessibilité (WCAG 2.1 Niveau AA) et suggère des améliorations.

Quand l'utiliser

  • Lors de la construction ou de la revue de composants d'interface utilisateur
  • Lorsque les utilisateurs demandent des améliorations d'accessibilité
  • En préparation d'un audit d'accessibilité
  • Lorsque l'utilisateur mentionne "accessibilité", "a11y", "WCAG", "lecteur d'écran" ou "navigation au clavier"

Instructions

1. Vérification du HTML sémantique

Utiliser les éléments HTML appropriés :

<!-- Mauvais -->
<div onclick="submit()">Envoyer</div>

<!-- Bon -->
<button onclick="submit()">Envoyer</button>

Structure sémantique :

  • <header>, <nav>, <main>, <footer>
  • <article>, <section>, <aside>
  • <h1> à <h6> dans une hiérarchie correcte
  • <button> pour les actions, <a> pour la navigation

2. Attributs ARIA

Quand utiliser ARIA :

  • Widgets personnalisés (onglets, accordéons, fenêtres modales)
  • Mises à jour de contenu dynamique
  • Interactions complexes
  • Lorsque le HTML sémantique ne suffit pas

Attributs ARIA courants :

<!-- Rôles de repère -->
<nav role="navigation" aria-label="Principal">

<!-- Rôles de widget -->
<div role="button" tabindex="0" aria-pressed="false">

<!-- Régions live -->
<div role="alert" aria-live="assertive">Erreur survenue</div>

<!-- Étiquettes et descriptions -->
<button aria-label="Fermer la boîte de dialogue">×</button>
<input aria-describedby="aide-mot-de-passe" />

Première règle d'ARIA : Ne pas utiliser ARIA si le HTML sémantique fonctionne

3. Navigation au clavier

Tous les éléments interactifs doivent être accessibles au clavier :

// Ajouter la prise en charge clavier aux éléments personnalisés
<div
  role="button"
  tabindex="0"
  onClick={handleClick}
  onKeyDown={(e) => {
    if (e.key === 'Enter' || e.key === ' ') {
      handleClick();
    }
  }}
>
  Cliquez-moi
</div>

Ordre de tabulation :

  • Utiliser tabindex="0" pour les éléments interactifs personnalisés
  • Éviter tabindex > 0 (crée un ordre de tabulation confus)
  • Utiliser tabindex="-1" pour le focus programmatique uniquement

Gestion du focus :

  • Indicateurs de focus visibles
  • Piéger le focus dans les fenêtres modales
  • Restituer le focus lors de la fermeture des boîtes de dialogue
  • Liens d'évitement pour le contenu principal

4. Texte alternatif et images

Images informatives :

<img src="graphique.png" alt="Les ventes ont augmenté de 25 % au 3e trimestre" />

Images décoratives :

<img src="decoration.png" alt="" />
<!-- ou -->
<img src="decoration.png" role="presentation" />

Images complexes :

<figure>
  <img src="graphique-complexe.png" alt="Graphique des ventes trimestriel" />
  <figcaption>
    Description détaillée des données du graphique...
  </figcaption>
</figure>

5. Couleur et contraste

Rapports de contraste (WCAG AA) :

  • Texte normal : 4,5:1 minimum
  • Texte large (18pt+) : 3:1 minimum
  • Composants d'interface : 3:1 minimum

Ne pas se fier uniquement à la couleur :

<!-- Mauvais : couleur uniquement -->
<span style="color: red;">Erreur</span>

<!-- Bon : icône + couleur -->
<span style="color: red;">
  <svg aria-hidden="true"><!-- icône d'erreur --></svg>
  <span class="sr-only">Erreur : </span>
  Saisie invalide
</span>

6. Formulaires et étiquettes

Chaque champ de saisie nécessite une étiquette :

<!-- Étiquette explicite -->
<label for="email">Email</label>
<input id="email" type="email" />

<!-- Étiquette implicite -->
<label>
  Email
  <input type="email" />
</label>

<!-- aria-label pour les boutons avec icône -->
<button aria-label="Rechercher">
  <svg><!-- icône de recherche --></svg>
</button>

Messages d'erreur :

<input
  id="mot-de-passe"
  aria-invalid="true"
  aria-describedby="erreur-mot-de-passe"
/>
<div id="erreur-mot-de-passe" role="alert">
  Le mot de passe doit comporter au moins 8 caractères
</div>

7. Titres et structure du document

Hiérarchie correcte des titres :

<h1>Titre de la page</h1>
  <h2>Section 1</h2>
    <h3>Sous-section 1.1</h3>
    <h3>Sous-section 1.2</h3>
  <h2>Section 2</h2>

Ne pas sauter de niveaux : h1 → h2 → h3 (pas h1 → h3)

8. Contenu dynamique

Annoncer les mises à jour aux lecteurs d'écran :

<!-- Poli : attendre une pause de l'utilisateur -->
<div role="status" aria-live="polite">
  5 nouveaux messages
</div>

<!-- Impératif : interrompre immédiatement -->
<div role="alert" aria-live="assertive">
  Votre session expirera dans 1 minute
</div>

États de chargement :

<button aria-busy="true" aria-label="Chargement...">
  <span aria-hidden="true">Chargement</span>
</button>

9. Test avec lecteur d'écran

Texte réservé au lecteur d'écran :

.sr-only {
  position: absolute;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip: rect(0, 0, 0, 0);
  white-space: nowrap;
  border-width: 0;
}

Masquer les éléments décoratifs :

<svg aria-hidden="true"><!-- icône --></svg>

10. Problèmes courants à vérifier

Manquants :

  • Texte alternatif sur les images
  • Étiquettes sur les champs de formulaire
  • Hiérarchie correcte des titres
  • Indicateurs de focus clavier
  • Étiquettes ARIA sur les boutons avec icône

Inappropriés :

  • Texte à faible contraste
  • Balisage non sémantique (divs comme boutons)
  • Gestion de focus manquante dans les modales
  • Pièges de tabulation
  • Média en lecture automatique

Tests :

  • Navigation uniquement au clavier
  • Lecteur d'écran (NVDA, JAWS, VoiceOver)
  • Simulation de daltonisme
  • Zoom à 200 %
  • Outils automatisés (axe, Lighthouse)

11. Tests automatisés

Outils :

# Lighthouse
npx lighthouse https://example.com --only-categories=accessibility

# axe-core
npm install --save-dev @axe-core/cli
npx axe https://example.com

# pa11y
npm install --save-dev pa11y
npx pa11y https://example.com

Dans les tests :

import { axe } from 'jest-axe';

test('ne doit pas avoir de violations d\'accessibilité', async () => {
  const { container } = render(<MyComponent />);
  const results = await axe(container);
  expect(results).toHaveNoViolations();
});

12. Checklist WCAG 2.1 Niveau AA

Perceptible :

  • Alternatives textuelles pour le contenu non textuel
  • Sous-titres pour l'audio/vidéo
  • Contenu adaptable (balisage sémantique)
  • Contraste des couleurs suffisant

Opérable :

  • Accessible au clavier
  • Pas de pièges de tabulation
  • Limites de temps adéquates (ajustables)
  • Pas de clignotement provoquant des crises
  • Liens d'évitement de navigation
  • Titres de page descriptifs
  • Ordre de focus logique
  • But du lien clair à partir du contexte

Compréhensible :

  • Langue de la page spécifiée (<html lang="fr">)
  • Navigation prévisible
  • Aide à la saisie (étiquettes, instructions, messages d'erreur)

Robuste :

  • HTML valide
  • Nom, rôle, valeur pour les widgets personnalisés
  • Compatible avec les technologies d'assistance

Meilleures pratiques

  • Intégrer l'accessibilité dès le départ
  • Tester avec de vraies technologies d'assistance
  • Utiliser le HTML sémantique en premier, ARIA en second
  • Maintenir une structure de document logique
  • Fournir plusieurs moyens d'accéder au contenu
  • Tester minutieusement la navigation au clavier
  • Ne pas désactiver le zoom
  • Utiliser des repères et des titres

Fichiers d'accompagnement

  • reference/wcag-checklist.md : Checklist complète WCAG 2.1 AA
  • reference/aria-patterns.md : Modèles de widgets ARIA courants

Individual skills in this repo

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

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Skills associés