Técnica HTML WCAG 2.2 obsoleta

H45Describir imágenes complejas con longdesc (técnica obsoleta)

Nombre oficial en el W3C: Usar longdesc

Técnica obsoleta: el W3C ya no la recomienda. |

En pocas palabras

Técnica obsoleta. El atributo longdesc enlazaba una imagen con una descripción larga, útil para gráficos o mapas. Hoy no forma parte de HTML y los navegadores no lo usan. La descripción larga debe ponerse en la propia página o en un enlace visible junto a la imagen.

Por qué es importante

Un gráfico de barras o un plano de evacuación tienen demasiada información para un alt corto. Las personas ciegas necesitan una explicación completa de los datos o del recorrido.

Si esa explicación depende de longdesc, casi nadie llega a ella. Los navegadores no lo muestran. Y pocos lectores de pantalla (programas que leen en voz alta lo que hay en la pantalla) lo anuncian. Además, quien ve bien tampoco sabe que existe.

Cómo se hace

No use longdesc en contenidos nuevos.
Dé a la imagen un alt breve que diga qué es: «Gráfico de visitas a la biblioteca en 2026».
Ponga la descripción completa en el texto, justo antes o después de la imagen. Por ejemplo, con una tabla con los mismos datos.
Si es muy larga, enlácela con un texto visible: «Descripción detallada del gráfico».
Puede agruparlo todo en <figure> con <figcaption>, o unir la descripción a la imagen con aria-describedby.

Cómo comprobarlo

Busque en el código el atributo longdesc.
Si aparece, compruebe si la descripción a la que apunta también se puede alcanzar desde un enlace o texto visible.
Si solo se llega por longdesc, proponga mover la descripción a la página o añadir un enlace visible.
En las imágenes complejas, confirme que la descripción transmite toda la información importante.

Ver el texto completo del W3C (traducción al español)

Esta es una traducción no oficial al español de la técnica H45 de Techniques for WCAG 2.2, del W3C. Puede contener errores. El único documento oficial y normativo es la versión original en inglés, publicada en el sitio web del W3C.

Aplicabilidad

Documentos HTML que incluyen imágenes que no pueden describirse con una alternativa textual corta.

Descripción

El objetivo de esta técnica es proporcionar información en un archivo designado por el atributo longdesc cuando una alternativa textual corta no transmite adecuadamente la función o la información que ofrece la imagen. El atributo longdesc es un URI cuyo destino contiene una descripción larga del contenido no textual.

Los autores pueden proporcionar la descripción de una imagen incluyendo el texto en un recurso independiente o dentro del texto de la página que contiene la imagen. Una ventaja de usar un recurso independiente para la descripción es que se puede reutilizar fácilmente para varias instancias de la misma imagen, no añade ruido visual al documento original y el final de la descripción resulta evidente para el usuario. Una ventaja de proporcionar la descripción en la misma página que la imagen es que todos los usuarios pueden acceder a ella. Una limitación del método en la misma página, así como del de ofrecer varias descripciones en una única página independiente, es que las implementaciones actuales compatibles con longdesc no identifican el punto final de la descripción larga. Los autores pueden resolverlo proporcionando una descripción bien formada que indique dónde termina.

Ejemplos

Usar longdesc para remitir a una descripción larga contenida en un recurso independiente.

<p><img src="chart.gif" alt="a complex chart" longdesc="chartdesc.html"/></p>

Usar longdesc para remitir a una descripción larga dentro de la misma página.

<img longdesc="thispage.html#desc" alt="Line graph of the number of subscribers" src="http://www.company/images/graph.png">
<div id="desc">
<h3>Long Description: Line graph of the number of subscribers</h3>
<!-- Full Description of Graph -->
<p>Long description ends.</p>
<div>

Pruebas

Procedimiento

Comprobar que el elemento img tiene un atributo longdesc.
Comprobar que el valor del atributo longdesc es un URI válido de un recurso existente.
Comprobar que el contenido del destino de ese URI contiene una descripción larga que describe el contenido no textual original asociado a él.

Resultados esperados

Las comprobaciones n.º 1 a n.º 3 son todas verdaderas.

Recursos

University of Minnesota Duluth listing of longdesc Tools (lista de herramientas compatibles con longdesc de la Universidad de Minnesota Duluth)

Cómo lo comprobamos en ADDAW

En cada auditoría de ADDAW revisamos esta técnica página a página y le entregamos los errores con capturas y la forma de corregirlos.

Solicitar una auditoría

Basado en la técnica H45 del W3C (WCAG 2.2). Explicación y ejemplos: ADDAW. Traducción no oficial del texto del W3C © W3C, licencia de documentos del W3C. ¿Ha visto un error? Escríbanos.