link-name-quality
Le texte des liens devrait être descriptif, pas générique
Signale les liens dont le nom accessible complet est une formule connue pour être peu descriptive (par exemple « click here », « read more », « more ») ou un simple nom de format de fichier (par exemple « HTML », « PDF ») sans contexte adjacent indiquant vers quoi ils mènent, pour une revue manuelle de la clarté de leur fonction. Les expressions anglaises sont toujours reconnues, et les allemandes, espagnoles, françaises ou japonaises lorsque le lien est dans cette langue.
Applicabilité. a[href], area[href] et éléments dont l’attribut role se résout en link (son premier vrai jeton de rôle, sans tenir compte de la casse) dont le nom accessible calculé n’est pas vide (aria-labelledby, aria-label, le contenu, puis title, dans l’ordre d’accname ; même sélecteur que link-name-present). Les liens sans aucun nom relèvent de link-name-present, pas de cette règle. Un élément personnalisé auquel ses ElementInternals donnent le rôle link (this.attachInternals().role), sans attribut role qui en nomme un autre, compte comme un élément natif doté de ce rôle.
Attendu. Le nom accessible complet du lien, une fois normalisé (espaces retirés aux extrémités, casse neutralisée, ponctuation finale supprimée), ne correspond exactement ni à une formule connue pour être peu descriptive (« click here », « read more », « more », « here », « details », « link », etc., le motif d’échec connu de la technique WCAG F84 pour le critère 2.4.4), ni à un simple nom de format ou de type de fichier (« HTML », « PDF », « EPUB », ...) dépourvu de contexte adjacent (une cible aria-describedby, le texte hors liens de l’élément de liste, de la cellule de tableau ou du paragraphe englobant, y compris celui de ses éléments en ligne, ou, pour les noms de format uniquement, un en-tête de la première ligne d’un tableau) indiquant à quoi il se rapporte.
Ce que rapporte un constat.
normalizedName: le nom accessible du lien tel qu’il a été comparé : en minuscules, espaces fusionnés et ponctuation finale retirée. C’est une formule générique (GENERIC_LINK_TEXT) ou un simple nom de format (AMBIGUOUS_FORMAT_NAME).
Ces champs de data.details aident à lire et à reproduire un constat. À part reasonCode et les quelques champs que la page Schéma de sortie donne comme stables, ils ne constituent pas un contrat stable : un champ peut être renommé ou supprimé dans une version mineure, ne vous appuyez donc pas dessus.
Exemples
<a href="/x">Click here</a>
« Click here » est une formule générique connue qui ne décrit pas la destination du lien hors contexte.
<a href="/x">Download the 2026 pricing guide</a>
Le texte du lien est précis et descriptif.
Comment vérifier
Quand cette règle ne peut pas trancher, elle renvoie cantTell et laisse la question à une personne. Chaque question qu’elle peut poser figure ici sous son code de raison, avec les étapes pour y répondre. Un constat porte les mêmes étapes dans howToCheck, dans la langue de l’analyse. Voir Schéma de sortie.
AMBIGUOUS_FORMAT_NAME
- Repérez le lien indiqué par le rapport ; son texte n’est qu’un format, comme « PDF ».
- Lisez le texte qui l’entoure (la phrase, l’élément de liste, la ligne de tableau ou le titre au-dessus) et voyez s’il nomme le document.
- Suivez le lien et confirmez que le document est bien celui que nomme ce contexte.
Réussite. La phrase, l’élément de liste, la ligne ou le titre qui l’entoure nomme le document : le lien se comprend alors, par exemple, comme le rapport annuel en PDF.
Échec. Rien près du lien n’indique de quel document il s’agit : la destination n’est pas claire, ce qui ne respecte pas le critère WCAG 2.4.4 ; un texte de lien peu clair à lui seul ne respecte pas le critère 2.4.9.
GENERIC_LINK_TEXT
- Repérez le lien indiqué par le rapport et lisez son texte, comme « lire la suite » ou « cliquez ici ».
- Lisez la phrase, l’élément de liste, la cellule de tableau ou le titre qui l’entoure directement, comme le ferait une personne qui utilise le lien.
- Demandez-vous si le texte du lien, avec ce contexte, indique clairement où mène le lien ; vérifiez ensuite si une liste de liens (le texte du lien seul) le ferait.
- Suivez le lien et confirmez qu’il mène là où le contexte l’indique.
Réussite. Le texte du lien, avec la phrase, l’élément de liste, la cellule ou le titre qui l’entoure, rend la destination claire ; pour le niveau AAA, le texte du lien seul y suffit.
Échec. Ni le texte du lien ni son contexte n’indiquent où il mène, ce qui ne respecte pas le critère WCAG 2.4.4 (F84) ; un texte de lien peu clair à lui seul ne respecte pas le critère 2.4.9.