# Rapport de contraste

## Ce que c'est

Un rapport de contraste est une valeur numérique comprise entre 1:1 et 21:1 que WCAG utilise pour déterminer si le texte, les icônes et les autres éléments visibles d'une page se détachent de ce qui se trouve derrière. Il compare la luminance de deux couleurs : il mesure donc une différence de clarté et ignore entièrement la teinte. Les designers parlent souvent de contraste des couleurs ou de contraste de luminance, et les audits donnent des rapports par paire de couleurs ; toutes ces expressions désignent le même calcul.

La formule est courte. Prenez la luminance relative de la couleur la plus claire, L1, et celle de la plus sombre, L2, puis divisez (L1 + 0,05) par (L2 + 0,05). La luminance relative est normalisée de 0 pour le noir le plus sombre à 1 pour le blanc le plus clair. Pour une couleur sRGB, chaque canal est d'abord converti de sa valeur encodée avec un gamma en lumière linéaire ; les trois sont ensuite pondérés : 0,2126 pour le rouge, 0,7152 pour le vert et 0,0722 pour le bleu. Deux couleurs identiques donnent 1:1, et le noir sur blanc donne 21:1.

Ces pondérations déjouent l'intuition. Le vert pur sur noir mesure environ 15,3:1, tandis que le bleu pur sur noir n'atteint qu'environ 2,4:1, alors que les deux paraissent aussi vifs. Le rouge pur sur blanc donne 3,998:1. Le gris moyen `#767676` sur blanc mesure 4,54:1, et `#777777`, plus clair d'un cran, mesure 4,48:1. Le calcul tient en une douzaine de lignes :

```js
// Contrast ratio of two sRGB colours, as WCAG 2.2 defines it
const linear = (c) => {
    const s = c / 255;
    return s <= 0.04045 ? s / 12.92 : ((s + 0.055) / 1.055) ** 2.4;
};
const luminance = (rgb) => {
    const [r, g, b] = rgb.map(linear);
    return 0.2126 * r + 0.7152 * g + 0.0722 * b;
};
const contrast = (a, b) => {
    const [hi, lo] = [luminance(a), luminance(b)].sort((x, y) => y - x);
    return (hi + 0.05) / (lo + 0.05);
};
contrast([118, 118, 118], [255, 255, 255]); // 4.54...
```

Dans WCAG 2.2, le rapport est une définition, et quatre critères de succès lui fixent des seuils :

- **1.4.3 Contraste (minimum), niveau AA :** au moins 4,5:1 pour le texte et les images de texte, et au moins 3:1 pour le texte de grande taille. Le texte d'un contrôle inactif, la décoration pure et les logotypes ne sont soumis à aucune exigence de contraste.
- **1.4.6 Contraste (amélioré), niveau AAA :** au moins 7:1, et 4,5:1 pour le texte de grande taille.
- **1.4.11 Contraste du contenu non textuel, niveau AA :** au moins 3:1 avec les couleurs adjacentes pour ce qui identifie un contrôle et son état, ainsi que pour les parties d'un graphique nécessaires à sa compréhension.
- **2.4.13 Apparence du focus, niveau AAA :** l'indicateur de focus doit varier d'au moins 3:1 entre les états avec et sans focus, sur une surface au moins égale à celle du périmètre du contrôle tracé avec une épaisseur de 2 pixels CSS.

Le texte de grande taille est un texte d'au moins 18 points, ou d'au moins 14 points en gras. En pixels CSS, cela représente 24px, ou environ 18,7px en gras.

## Pourquoi c'est important

Les seuils viennent de pertes de vision mesurées, et connaître leur origine aide lorsque quelqu'un veut les assouplir. Le document explicatif de WCAG part de 3:1, le minimum fixé par une norme ANSI pour des observateurs ayant une vision typique. Une vision de 20/40 s'accompagne d'une sensibilité au contraste réduite d'un facteur d'environ 1,5 : 3 × 1,5 donne donc 4,5:1. Le même document note que 20/40 est souvent présenté comme l'acuité typique vers 80 ans. Le seuil AAA de 7:1 compense une vision proche de 20/80. Comme le rapport n'utilise que la luminance, il reste valable pour la plupart des déficiences de perception des couleurs, contrairement à des règles fondées sur la teinte. La même marge aide toute personne qui lit un téléphone en plein soleil.

La décision que tranche un rapport de contraste est donc celle des couleurs qu'une marque peut employer pour chaque usage, et cette décision coûte beaucoup moins cher au stade de la palette qu'à celui de la page. Une couleur de marque à 3,2:1 sur blanc garde des usages : grands titres, icônes et contour d'un champ de formulaire, qui demandent 3:1, fonds derrière du texte sombre, décoration et logo lui-même. En revanche, elle ne peut pas servir au corps du texte, aux liens dans un paragraphe ou au texte indicatif des champs, qui demandent tous 4,5:1. Décider cela une seule fois dans les tokens de design prend un après-midi. Le découvrir après le lancement oblige à recolorer chaque composant qui a repris cette couleur, et un thème sombre double le nombre de paires à vérifier.

Le contraste est aussi l'une des rares exigences WCAG qu'une machine peut vérifier exactement, à condition de connaître les deux couleurs. C'est donc le premier constat dans la plupart des audits automatisés et la première question de nombreuses listes de contrôle d'achat ; le niveau AA est celui que les règles d'accessibilité et les contrats citent le plus souvent. Viser partout les 7:1 du niveau AAA est un choix à peser : WCAG déconseille lui-même d'exiger AAA comme politique pour des sites entiers, mais 7:1 est un objectif solide pour les textes destinés à une lecture prolongée lorsque la palette le permet.

## À quoi cela ressemble en pratique

Deux pages de ce site montrent le rapport conservé comme mesure consignée plutôt que jugé à l'œil.

Lors de la clôture du système de couleurs du site,
[chacune des 28 couleurs a été documentée avec son rapport de contraste](/fr/portfolio/closed-the-colour-system-at-28-colours/)
sur la surface où elle apparaît, et onze valeurs de marque ont été déclarées une seule fois sous forme de tokens. Un contrôle de lint échoue dans cinq cas, dont celui d'une couleur assortie d'un rapport erroné. La règle permanente interdit notamment d'abaisser un rapport documenté pour faire fonctionner un design, et toute justification d'une vingt-neuvième couleur doit inclure son rapport. La même page fixe un second seuil, une distance perceptuelle de 0,02 dans un espace colorimétrique uniforme, qui décide quand deux notations représentent en réalité une même couleur. Cette valeur distingue les entrées de palette ; c'est une mesure différente du contraste.

Le cas du texte sur une photographie était plus difficile. Le travail visant à
[appliquer WCAG 2.2 niveau AA à l'ensemble du site](/fr/portfolio/a-site-that-meets-the-accessibility-standard/)
a notamment remplacé un raisonnement sur le contraste par une mesure : le moteur de règles automatisées avait déclaré ce texte impossible à évaluer. Une mesure revérifiée le 2026-09-30 a trouvé 49 des 64 paires page-thème sous AA sur les fonds les plus défavorables du jeu d'images ; deux surfaces restées hors du contrôle du design étaient en cause. Le contrôle qui les a trouvées constitue désormais un plancher : chaque paire vérifiée doit atteindre AA sur le fond choisi par le build, et toute paire insuffisante fait échouer le build. Il s'agit d'un contrôle du contraste dans le périmètre échantillonné, et non d'une preuve de conformité complète de tout le site au niveau AA.

## Où les problèmes surviennent

**Le texte sur une photographie passe dans l'outil et échoue à l'écran.** WCAG mesure le texte par rapport à son fond déclaré et suppose du blanc lorsqu'aucun n'est défini. Un titre sur une image principale a un fond déclaré qui n'est pas celui sous ses lettres ; un vérificateur mesure alors la mauvaise paire ou renvoie l'élément à un examen manuel. Mesurez par rapport aux pixels les plus clairs et les plus sombres sur lesquels le texte peut se trouver, pour chaque recadrage et largeur, ou donnez au texte un fond uni ou couvert d'un voile, dont la couleur résultante est connue.

**Un token mesure 4,6:1 et la page affiche 3,9:1.** L'opacité, le texte en `rgba()`, un calque translucide ou un mode de fusion change la couleur qui atteint l'écran : le rapport consigné pour le token décrit alors une couleur que personne ne voit. Calculez le rapport de la paire après composition, ou n'utilisez aucun alpha sur le texte.

**Un audit déclare 4,49:1 conforme.** Un affichage à une décimale transforme 4,49 en 4,5. Le document explicatif précise que les seuils ne s'arrondissent pas : 4,499:1 ne satisfait pas 4,5:1. Conservez au moins deux décimales et comparez la valeur brute au seuil.

**Le thème clair est vérifié, le thème sombre est livré sans autre vérification.** Chaque thème et chaque état qu'une couleur peut prendre forment une paire distincte : survol, focus, lien visité, erreur et texte indicatif, qui compte comme texte et exige 4,5:1. Un contrôle désactivé est exempté. Générez la liste des paires à partir des tokens, par thème et par état, puis vérifiez cette liste plutôt qu'une capture d'écran.

**Une police fine passe sur le papier et s'efface à l'écran.** Le rapport vient des couleurs déclarées, mais l'anticrénelage dessine les graisses très fines plus pâles que leur couleur CSS ; le document explicatif décrit ce cas : le texte peut être nominalement conforme tout en offrant à la lecture un contraste bien plus faible. Augmentez le rapport pour les graisses légères, ou choisissez une graisse plus forte dans la même famille.

## Pour aller plus loin

- [WCAG 2.2 : rapport de contraste](https://www.w3.org/TR/WCAG22/#dfn-contrast-ratio) — la définition normative et ses notes sur la couleur de fond, le blanc retenu lorsque la couleur de fond n'est pas précisée et l'anticrénelage.
- [Comprendre le critère 1.4.3, Contraste (minimum)](https://www.w3.org/WAI/WCAG22/Understanding/contrast-minimum.html) — l'origine de 4,5:1 et de 3:1, la définition du texte de grande taille et l'absence d'arrondi des rapports.
- [Comprendre le critère 1.4.11, Contraste du contenu non textuel](https://www.w3.org/WAI/WCAG22/Understanding/non-text-contrast.html) — la règle de 3:1 pour les contrôles, leurs états et les graphiques porteurs de sens, avec des exemples conformes et non conformes.
- [Comprendre le critère 1.4.6, Contraste (amélioré)](https://www.w3.org/WAI/WCAG22/Understanding/contrast-enhanced.html) — le niveau AAA à 7:1 et les lecteurs auxquels il est destiné.
- [CSS Color Module Level 4](https://www.w3.org/TR/css-color-4/) — la fonction de transfert sRGB et les espaces colorimétriques supposés par la formule de luminance.

<https://engineer.company/fr/glossary/contrast-ratio/>
