Scanverra

Cómo solucionar el texto alternativo faltante en imágenes

El texto alternativo es la alternativa textual adjunta a una etiqueta <img>: lo que un lector de pantalla anuncia en lugar de la imagen, y lo que los motores de búsqueda usan para entender lo que realmente muestra la imagen. Una imagen sin ningún atributo alt es a la vez un fallo de accesibilidad y una oportunidad de SEO desperdiciada.

Por qué falta el texto alternativo

El texto alternativo faltante rara vez es deliberado. Las causas habituales:

  • Subidas del CMS sin campo obligatorio. La mayoría de los editores de contenido permiten publicar una imagen sin pedir nunca el texto alternativo, así que este queda vacío por defecto sin avisar.
  • Marcado copiado y pegado. Una etiqueta <img> copiada de otra parte del sitio (o de un ejemplo de una librería de componentes) arrastra el texto alternativo que tuviera el original, o su ausencia.
  • Componentes de icono tratados como decoración por defecto. Las librerías de iconos SVG y las fuentes de iconos a menudo no incluyen un nombre accesible a menos que lo añada explícitamente, y es fácil asumir que el componente que lo rodea ya se encarga de ello cuando no es así.
  • Imágenes descriptivas marcadas por error como decorativas, o al revés. Invertir esta distinción es casi tan frecuente como olvidarla por completo.

Cómo identificar cada caso faltante

Esta es una de las pocas verificaciones que Scanverra puntúa directamente en lugar de limitarse a mostrarla. Durante un escaneo de Prueba de navegador, Scanverra ejecuta Array.from(document.querySelectorAll("img")).filter((img) => !img.alt) contra su página renderizada y reporta cada coincidencia como un problema distinto de "Atributo alt faltante", listando hasta los primeros 10 por escaneo junto con el origen de la imagen para que pueda encontrarla rápidamente. Una auditoría real independiente de Lighthouse image-alt también contribuye a su puntuación de accesibilidad, así que un problema de alt faltante aparece en dos sitios, no como una sola suposición.

Cómo solucionarlo

1. Escriba una descripción real para las imágenes con significado

Describa lo que la imagen transmite en su contexto, no lo que literalmente es: omita "imagen de" o "foto de", ya que los lectores de pantalla ya la anuncian como una imagen:

Describa el contenido, no el archivotypescript
1<img
2  src="/keyboard-side-profile.webp"
3  alt="Mechanical keyboard with low-profile keys and RGB backlighting"
4  width={480}
5  height={320}
6/>

2. Marque las imágenes puramente decorativas como vacías, no como faltantes

Un alt vacío le indica a los lectores de pantalla que la omitan, no que adivinentypescript
1<img src="/divider-flourish.svg" alt="" role="presentation" />

3. Dé a los iconos funcionales un nombre accesible para la acción que realizan

Describa la acción del botón, no la forma del iconotypescript
1<button aria-label="Search">
2  <SearchIcon aria-hidden="true" />
3</button>

4. No rellene el texto alternativo con palabras clave

Un texto alternativo que suena como una cadena de palabras clave de SEO en lugar de una descripción real falla tanto en su propósito de accesibilidad (no le sirve de nada a un usuario de lector de pantalla) como, en la práctica, no aporta nada a las clasificaciones: escríbalo para la persona que no puede ver la imagen.

Cómo detecta Scanverra los problemas de texto alternativo

La Prueba de navegador de Scanverra inspecciona genuinamente cada elemento &lt;img&gt; renderizado en la página y puntúa los hallazgos de alt faltante como problemas de accesibilidad reales, limitados a los primeros 10 por escaneo: no es un campo meramente informativo, se contabiliza contra su puntuación.

FAQ

Frequently asked questions

¿Necesitan texto alternativo las imágenes decorativas?

No, y darles un texto alternativo descriptivo sería en realidad un error. Una imagen puramente decorativa (un adorno de fondo, un separador gráfico) debería tener alt="" (un atributo vacío pero presente) para que los lectores de pantalla la omitan en silencio en lugar de leer en voz alta una descripción sin sentido.

¿Cuántas imágenes con alt faltante reporta Scanverra por escaneo?

Hasta 10 por escaneo, cada una reportada con el origen de su imagen para que pueda encontrarla rápidamente. Si a su página le faltan más de 10, solucionar el primer lote y volver a escanear hará visible el resto.

¿El texto alternativo realmente afecta al ranking SEO, o es puramente una cuestión de accesibilidad?

Ambas cosas. Los lectores de pantalla dependen de él para describir las imágenes a los usuarios que no pueden verlas, y también es una de las pocas señales que tienen los motores de búsqueda sobre lo que una imagen realmente muestra, ya que no pueden interpretar los píxeles con la misma fiabilidad que una persona.

¿Qué debería escribir para un icono puramente funcional, como un botón de búsqueda con una lupa?

Describa la acción, no el icono: alt="Buscar" o aria-label="Buscar", no alt="Icono de lupa". Si el icono está junto a un texto visible que ya dice "Buscar", marque el icono como decorativo en su lugar para que no se anuncie dos veces.

¿Es diferente un atributo alt faltante de uno vacío?

Sí, y la diferencia importa. Un atributo alt faltante (ningún atributo en absoluto) se trata como un error: los lectores de pantalla a menudo recurren a leer el nombre del archivo. Un alt="" explícitamente vacío es, en cambio, una señal válida e intencionada de que la imagen es decorativa.

Free - no sign-up required

Encuentre cada etiqueta alt faltante en su sitio

Realice una auditoría de accesibilidad gratuita y obtenga las imágenes exactas con texto alternativo faltante, no solo una puntuación.

Run free audit