edubun
Español

Texto alternativo para imágenes

Un adorno en espiral y un gráfico de ventas usan el mismo elemento img, pero el texto alt correcto para el primero es una cadena vacía y para el segundo, una oración completa.

Para qué sirve el texto alt

Un lector de pantalla convierte una página en voz o en braille. Cuando llega a una imagen no puede mirar los píxeles, así que lee el atributo alt. Ese mismo texto aparece cuando una imagen no carga, y es lo que recibe un buscador o un navegador de solo texto. WCAG 2.2 pone esto en primer lugar: el criterio de conformidad 1.1.1 Contenido no textual, de nivel A, pide que toda imagen, ícono o gráfico que transmita información tenga una alternativa textual que cumpla el mismo propósito.

Las palabras clave son "el mismo propósito". El texto alt no es un pie de foto ni una lista de todo lo que sale en el cuadro. Pregúntate qué obtiene de la imagen, en ese lugar, un lector que ve, y escribe eso. La foto de un pan en la página de inicio de una panadería quizá solo necesite "Pan de masa madre, rebanado". La misma foto en un artículo sobre el color de la corteza podría necesitar "Pan de masa madre con la corteza oscura, casi negra, y una miga abierta". El mismo archivo, otra función, otro texto.

Una versión breve del árbol de decisión de alt del W3C. Las imágenes de texto llevan como alt el propio texto.

Cuatro casos frecuentes

El tutorial de imágenes del W3C clasifica la mayoría de las imágenes en unos pocos grupos. Las imágenes informativas, como una foto o un diagrama sencillo, llevan una descripción breve de lo que muestran. Las imágenes decorativas, como una línea divisoria o una textura de fondo, llevan un alt vacío, escrito alt="", que le indica a la tecnología de apoyo que las salte. Las imágenes funcionales, como un logotipo que enlaza al inicio o una lupa que envía una búsqueda, llevan un texto que dice qué pasa: "Inicio de Corner Bakery" o "Buscar", no "logotipo" ni "lupa". Las imágenes de texto llevan las palabras que aparecen en la imagen.

Omitir el atributo no es lo mismo que dejarlo vacío. Sin ningún alt, algunos lectores de pantalla recurren a leer el nombre del archivo, y quien escucha puede oír algo como "IMG guion bajo 4032 punto jpeg". Un alt vacío es una decisión consciente que dice "aquí no hay nada que ver". Para un gráfico complejo, deja el alt corto ("Gráfico de barras de las ventas mensuales, descrito abajo") y pon los números en una tabla o un párrafo al lado, donde todos puedan leerlos.

Imágenes que no son elementos img

Las imágenes también pueden llegar como SVG en línea o como imágenes de fondo de CSS. Un fondo de CSS no tiene ningún lugar para el texto alt, así que solo debe usarse como decoración; todo lo que tenga significado va en el HTML. Un svg en línea que sea pura decoración se puede ocultar con aria-hidden="true", como explica la unidad 6. WCAG no fija un límite de caracteres para el texto alt, pero el tutorial del W3C vuelve una y otra vez al mismo consejo: sé breve y da lo que importa en ese contexto. Si te ves escribiendo tres oraciones, probablemente ese contenido debe ir en el texto de la página, donde todos puedan leerlo.

Puedes revisar tus propias páginas sin programas especiales. Mira el código fuente de la página y busca <img: cada resultado debe tener un atributo alt, vacío o no. Las herramientas para desarrolladores de los navegadores principales también incluyen un panel de accesibilidad que muestra el nombre que recibe cada imagen. Leer esos nombres seguidos, fuera de contexto, es una buena prueba. Si la lista dice "imagen, imagen, gráfico, logotipo", eso es exactamente lo que oye quien usa un lector de pantalla.

No empieces el texto alt con "imagen de" o "foto de". Los lectores de pantalla ya anuncian que el elemento es una imagen, así que esas palabras se oyen dos veces.
WCAG 1.1.1Contenido no textual, nivel A: alternativas textuales para imágenes con significado
alt=""Decorativa: la tecnología de apoyo salta la imagen
Imagen funcionalDescribe la acción o el destino
Imagen de textoEl alt repite las palabras de la imagen
Sin altAlgunos lectores de pantalla leen el nombre del archivo
Gráfico complejoAlt corto y los datos en un texto o una tabla cercanos
Ideas clave
  • El texto alt da el propósito de la imagen en su lugar de la página.
  • Las imágenes decorativas llevan alt="", no un atributo ausente.
  • Los enlaces y botones formados por una imagen necesitan un alt que nombre la acción.
  • Los datos extensos van en un texto o una tabla junto a la imagen.
  1. ¿Qué criterio de conformidad de WCAG 2.2 trata las alternativas textuales?
    • 1.1.1 Contenido no textual
    • 1.4.3 Contraste (mínimo)
    • 2.1.1 Teclado
    • 3.3.2 Etiquetas o instrucciones
  2. Una línea ondulada que solo separa dos secciones debe tener
    • alt=""
    • alt="línea ondulada"
    • ningún atributo alt
    • alt="imagen"
  3. Una imagen de lupa es el único contenido del botón de búsqueda. ¿Cuál es el mejor alt?
    • Buscar
    • Lupa
    • Ícono
    • Lupa azul sobre fondo blanco
  4. ¿Qué puede pasar cuando falta por completo el alt?
    • Algunos lectores de pantalla leen en voz alta el nombre del archivo
    • La imagen se oculta
    • La página no carga
    • El navegador inventa una descripción
  5. Una imagen de cartel muestra las palabras "Abierto de 7 a. m. a 6 p. m.". Su alt debe ser
    • Abierto de 7 a. m. a 6 p. m.
    • Cartel
    • Imagen del horario
    • alt=""
  6. ¿Por qué evitar que el alt empiece con "imagen de"?
    • Los lectores de pantalla ya dicen que es una imagen
    • Rompe el HTML
    • Los buscadores lo prohíben
    • Hace la imagen más grande
  7. ¿Qué atributo contiene la alternativa textual de una imagen?
  8. ¿Dónde deben ir los números de un gráfico detallado?
    • En una tabla o un texto cerca del gráfico
    • Todos dentro del atributo alt
    • En ningún lado, basta con el gráfico
    • En el nombre del archivo
  9. ¿El texto alt es lo mismo que un pie de foto?
    • No: el alt sustituye a la imagen; un pie de foto es texto visible adicional
    • Sí, siempre
    • Solo en el celular
    • Solo en las fotos
Fuentes de este curso (9)
  • W3C, Web Content Accessibility Guidelines (WCAG) 2.2, W3C Recommendation first published 5 October 2023, current edition 12 December 2024 (w3.org/TR/WCAG22/, checked 2026-10-17, rechecked 2026-10-18)
  • W3C WAI, What's new in WCAG 2.2 (w3.org/WAI/standards-guidelines/wcag/new-in-22/, checked 2026-10-17)
  • W3C WAI, Images tutorial and alt decision tree (w3.org/WAI/tutorials/images/decision-tree/, checked 2026-10-17)
  • W3C, Using ARIA (w3.org/TR/using-aria/, Discontinued Draft 24 February 2026, rules 1 to 4, checked 2026-10-17)
  • W3C WAI-ARIA Authoring Practices Guide, Read Me First, "No ARIA is better than bad ARIA" (w3.org/WAI/ARIA/apg/practices/read-me-first/, checked 2026-10-17)
  • MDN Web Docs, tabindex (developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/tabindex, checked 2026-10-17)
  • MDN, Heading elements, accessibility notes (developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/Heading_Elements, checked 2026-10-17)
  • MDN, autocomplete attribute (developer.mozilla.org/en-US/docs/Web/HTML/Reference/Attributes/autocomplete, checked 2026-10-17)
  • Every code exercise was checked with a Playwright probe against a reference solution.

Fecha de consulta: 2026-10-17