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>© 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
divetspanpour des éléments cliquables au lieu debuttonoua - 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-labelalors 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
altdescriptif (oualt=""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