link-name-quality
El texto del enlace debería ser descriptivo, no genérico
Marca los enlaces cuyo nombre accesible completo es una frase conocida no descriptiva (por ejemplo, "click here", "read more", "more") o un nombre de formato de archivo a secas (por ejemplo, "HTML", "PDF") sin contexto adyacente que indique a dónde lleva, para revisión manual sobre si el propósito es claro. Las frases en inglés se reconocen siempre, y las alemanas, españolas, francesas o japonesas cuando el enlace está en ese idioma.
Ámbito de aplicación. a[href], area[href] y elementos cuyo atributo role se resuelve en link (su primer token de rol real, sin distinguir mayúsculas de minúsculas) con un nombre accesible calculado no vacío (aria-labelledby, aria-label, el contenido y luego title, en el orden en que los dispone accname; el mismo selector que link-name-present). Los enlaces sin ningún nombre son competencia de link-name-present, no de esta regla. Un elemento personalizado cuyos ElementInternals le dan el rol link (this.attachInternals().role), sin un atributo role que nombre otro, cuenta como lo hace un elemento nativo con ese rol.
Resultado esperado. El nombre accesible completo del enlace, normalizado (sin espacios sobrantes, en minúsculas, sin puntuación final), no coincide exactamente con una frase conocida no descriptiva ("click here", "read more", "more", "here", "details", "link", etc., el patrón de fallo conocido de la técnica F84 de WCAG para el SC 2.4.4) ni con un nombre de formato/tipo de archivo a secas ("HTML", "PDF", "EPUB", ...) sin contexto adyacente (un destino de aria-describedby, el texto fuera de enlaces del elemento de lista/celda de tabla/párrafo que lo contiene, incluido el de sus elementos en línea, o (solo para nombres de formato) un encabezado de la primera fila de una tabla) que indique a qué pertenece.
Qué informa un hallazgo.
normalizedName: el nombre accesible del enlace tal como se comparó: en minúsculas, con los espacios colapsados y sin la puntuación final. Es una frase genérica (GENERIC_LINK_TEXT) o solo el nombre de un formato (AMBIGUOUS_FORMAT_NAME).linkKind: de qué está hecho el enlace (helpers.getLinkKind):svgpara un<a>en SVG;imagepara un<area>, o un enlace cuyo contenido son solo imágenes (<img>,<svg>,<object>,<canvas>,role="img");compositepara texto y una imagen;texten los demás casos, incluido un enlace sin contenido (nombrado por sus atributos). El contenido oculto (display: none,[hidden]) no cuenta; el contenido oculto solo conaria-hiddense dibuja, y sí cuenta.
Estos campos de data.details ayudan a leer y reproducir un hallazgo. Salvo reasonCode y los pocos campos que Esquema de salida indica como estables, no son un contrato estable: un campo puede cambiar de nombre o desaparecer en una versión menor, así que no construyas sobre ellos.
Ejemplos
<a href="/x">Click here</a>
"Click here" es una frase genérica conocida que no describe el destino del enlace fuera de contexto.
<a href="/x">Download the 2026 pricing guide</a>
El texto del enlace es específico y descriptivo.
Cómo comprobarlo
Cuando esta regla no puede decidir, informa cantTell y deja la pregunta a una persona. Cada pregunta que puede plantear aparece aquí bajo su código de motivo, con los pasos para responderla. Un hallazgo lleva los mismos pasos en howToCheck, en el idioma del análisis. Consulta Esquema de salida.
AMBIGUOUS_FORMAT_NAME
- Localizar el enlace que indica el informe; su texto es solo un formato, como «PDF».
- Leer el texto que lo rodea (la frase, el elemento de lista, la fila de la tabla o el encabezado que tiene encima) y ver si nombra el documento.
- Seguir el enlace y confirmar que el documento es el que nombra ese contexto.
Se cumple. La frase, el elemento de lista, la fila o el encabezado que lo rodea nombra el documento, así que el enlace se entiende, por ejemplo, como el informe anual en PDF.
No se cumple. Nada cerca del enlace dice qué documento es, así que el destino no está claro, lo que incumple WCAG 2.4.4; un texto de enlace que no es claro por sí solo incumple 2.4.9.
GENERIC_LINK_TEXT
- Localizar el enlace que indica el informe y leer su texto, como «leer más» o «haga clic aquí».
- Leer la frase, el elemento de lista, la celda de tabla o el encabezado que lo rodea, como lo haría quien usa el enlace.
- Preguntarse si el texto del enlace junto con ese contexto deja claro adónde va el enlace; después comprobar si lo dejaría claro una lista de enlaces (solo el texto del enlace).
- Seguir el enlace y confirmar que va adonde indica el contexto.
Se cumple. El texto del enlace junto con la frase, el elemento de lista, la celda o el encabezado que lo rodea deja claro el destino; para AAA, lo deja claro el texto del enlace por sí solo.
No se cumple. Ni el texto del enlace ni el contexto que lo rodea dicen adónde lleva, lo que incumple WCAG 2.4.4 (F84); un texto de enlace que no es claro por sí solo incumple 2.4.9.