# Texto alternativo

Source: https://allyway.ai/es/glossary/texto-alternativo

El texto alternativo es una breve descripción escrita de una imagen. Los lectores de pantalla la leen en voz alta y los navegadores la muestran cuando la imagen no se carga, de modo que las personas que no pueden ver la imagen también captan su significado.

## Por qué importa el texto alternativo

Sin texto alternativo, un lector de pantalla no tiene nada que decir sobre una imagen o, peor aún, lee el nombre del archivo: *«IMG guion bajo 4031 punto jpg»*. Los visitantes que no pueden ver la imagen se pierden lo que muestra, y los enlaces formados por imágenes pierden su sentido.

El texto alternativo también ayuda cuando las imágenes no se cargan e indica a los motores de búsqueda de qué trata una imagen.

![Lo que anuncia un lector de pantalla ante una imagen con y sin texto alternativo](https://placehold.co/1440x640/F4F4F5/A1A1AA?text=Image "Cómo anuncia un lector de pantalla una imagen con y sin texto alternativo.")

## Ejemplos buenos y malos

**Do:** Qué hacer

`alt="Woman in a navy dress smiling against a bright wall"`

Describe lo que importa en este contexto.

**Don't:** Qué evitar

`alt="image123.jpg"`

Un nombre de archivo no le dice nada al visitante.

## Qué texto alternativo para cada tipo de imagen

| Tipo de imagen | Qué escribir | Ejemplo |
|---|---|---|
| **Informativa** | Lo que muestra la imagen y es relevante aquí | `alt="Bar chart: sales doubled in 2025"` |
| **Enlace o botón** | Adónde lleva o qué hace | `alt="allyWay home"` |
| **Decorativa** | Nada: déjelo vacío | `alt=""` |
| **Gráfico o mapa** | Un resumen breve, con los detalles en el texto | `alt="Map of our 3 stores in Vienna"` |
| **Texto en una imagen** | El mismo texto | `alt="Summer sale – 20% off"` |

## Cómo escribir un buen texto alternativo

1. **Pregúntese qué función cumple la imagen**

   ¿Es información, un enlace o un adorno? La respuesta determina lo que debe escribir.
2. **Describa la finalidad, no los píxeles**

   Escriba lo que un visitante necesita saber en ese punto, no cada detalle visible.
3. **Sea breve**

   Normalmente basta con una frase clara. Muchas guías recomiendan no pasar de unos 125 caracteres.
4. **Omita «imagen de»**

   Los lectores de pantalla ya indican que se trata de una imagen.
5. **Deje vacío el atributo alt de las imágenes decorativas**

   Use `alt=""` para que los lectores de pantalla las omitan, pero no elimine el atributo.

> **Tip:** > **Regla práctica**
> Lo que diría para describir la imagen a alguien por teléfono es su texto alternativo.

## Cómo comprobar sus textos alternativos

1. Haga clic con el botón derecho en una imagen, elija **Inspeccionar** y busque el atributo `alt`.
2. Realice una [comprobación de accesibilidad gratuita](https://allyway.ai/es/free-wcag-accessibility-scanner-for-websites) para encontrar todas las imágenes sin texto alternativo.
3. Escuche la página con VoiceOver o NVDA.

```html title="Ejemplo"
<img src="dress.jpg"
     alt="Woman in a navy dress smiling against a bright wall">
```

> **Warning:** > **No omita nunca el atributo alt**
> Sin él, muchos lectores de pantalla leen en su lugar el nombre del archivo. En las imágenes decorativas, utilice un atributo `alt=""` vacío.

## Criterios WCAG relacionados

| Criterio | Nivel | En breve |
|---|---|---|
| [1.1.1 Contenido no textual](https://www.w3.org/WAI/WCAG22/Understanding/non-text-content.html) | A | Todo elemento no textual tiene una alternativa textual |
| [1.4.5 Imágenes de texto](https://www.w3.org/WAI/WCAG22/Understanding/images-of-text.html) | AA | Usar texto real en lugar de texto dentro de imágenes |
| [2.4.4 Propósito de los enlaces (en contexto)](https://www.w3.org/WAI/WCAG22/Understanding/link-purpose-in-context.html) | A | Los enlaces de imagen indican adónde llevan |
| [4.1.2 Nombre, función, valor](https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html) | A | Los controles tienen un nombre accesible |

## Preguntas frecuentes

Q: ¿Qué longitud debe tener un texto alternativo?
A: Breve: normalmente una frase. Las explicaciones más largas, como los datos de un gráfico, deben ir en el texto junto a la imagen.

Q: ¿Las imágenes decorativas necesitan texto alternativo?
A: Necesitan un atributo alt vacío (`alt=""`) para que los lectores de pantalla las omitan.

Q: ¿El atributo title es lo mismo que el texto alternativo?
A: No. Muchos lectores de pantalla ignoran `title`, y solo se muestra al pasar el cursor. Utilice siempre `alt`.
