# SVG accesible: texto alternativo para iconos y logotipos

Source: https://allyway.ai/es/glossary/svg-accesible

Un SVG accesible es un gráfico vectorial escalable que las tecnologías de apoyo pueden tratar correctamente: un SVG con significado lleva role="img" y una alternativa textual, un SVG decorativo se oculta con aria-hidden="true" y un icono dentro de un enlace o un botón deja el nombre al control. Los SVG son contenido no textual según el criterio WCAG 1.1.1, de nivel A.

Un SVG accesible consiste en dar a los gráficos vectoriales el mismo trato que a las imágenes: una alternativa textual cuando significan algo y silencio cuando no. Los logotipos, los iconos, las ilustraciones y los gráficos sencillos suelen ser SVG en línea y, sin marcado adicional, los lectores de pantalla o los omiten, o leen «imagen» sin nombre, o anuncian un revoltijo de datos de trazados. Unos pocos atributos marcan la diferencia.

## Qué significa

Todo SVG es contenido no textual según el criterio [WCAG 1.1.1 Contenido no textual](https://www.w3.org/WAI/WCAG22/Understanding/non-text-content.html) (nivel A): todo el contenido no textual que se presenta al usuario tiene una alternativa textual que cumple un propósito equivalente. Las excepciones también cuentan para los SVG: los controles necesitan un nombre que describa su propósito y la decoración debe implementarse de modo que las tecnologías de apoyo puedan ignorarla. Las reglas de prueba del W3C comprueban que un elemento SVG con un rol explícito tenga un nombre accesible que no esté vacío.

En la práctica hay cuatro casos:

| El SVG es… | Qué hacer | Técnica del W3C |
|---|---|---|
| Un gráfico o logotipo con significado | `role="img"` más `aria-label` o `aria-labelledby` que apunte a su `<title>` | ARIA6, ARIA10 |
| Decorativo (adorno, forma de fondo) | `aria-hidden="true"` y ningún `role` | Excepción de decoración |
| Un icono dentro de un enlace o un botón | Ocultar el SVG y dar nombre al control | Excepción de los controles, véase 4.1.2 |
| Un gráfico de datos o un diagrama | Un nombre corto más una descripción más larga o una tabla de datos | G95, ARIA15, G74 |

Un `<img src="logo.svg">` funciona como cualquier otra imagen y lleva un atributo `alt` (véase [texto alternativo](https://allyway.ai/es/glossary/texto-alternativo)). Lo difícil es el `<svg>` en línea, porque los navegadores no lo tratan como una imagen por defecto.

> **Note:** > **Un `<title>` por sí solo no basta**
> Un `<title>` dentro de un SVG suele mostrarse como descripción emergente, pero los lectores de pantalla lo leen de forma irregular. Combínelo con `role="img"` y con `aria-labelledby` que apunte al `id` del título.

## Ejemplos

```html title="Ejemplo"
<!-- Meaningful graphic -->
<svg role="img" aria-labelledby="award-title" viewBox="0 0 64 64">
  <title id="award-title">Winner of the 2026 Design Award</title>
  <path d="…" />
</svg>

<!-- Decorative wave -->
<svg aria-hidden="true" focusable="false" viewBox="0 0 400 40">
  <path d="…" />
</svg>

<!-- Icon in a button: the button carries the name -->
<button type="button" aria-label="Search">
  <svg aria-hidden="true" focusable="false" viewBox="0 0 24 24"><path d="…" /></svg>
</button>
```

La insignia del premio se anuncia como una imagen con su nombre. La onda es invisible para los lectores de pantalla, igual que otras [imágenes decorativas](https://allyway.ai/es/glossary/imagenes-decorativas). En el botón de búsqueda, el SVG permanece en silencio y el `aria-label` pasa a ser el [nombre accesible](https://allyway.ai/es/glossary/nombre-accesible) del botón; sin él tendría un [botón de icono](https://allyway.ai/es/glossary/boton-de-icono) que no dice nada. `focusable="false"` evita que los navegadores antiguos incluyan el SVG en el orden de tabulación.

**Do:** Qué hacer

Decida para cada SVG si tiene significado, añada `role="img"` y un nombre corto a los que lo tienen, oculte los decorativos con `aria-hidden="true"`, dé nombre al control y no al icono, y asegúrese de que los colores de los iconos cumplan también el [contraste de contenido no textual](https://allyway.ai/es/glossary/contraste-de-contenido-no-textual).

**Don't:** Qué evitar

Confiar solo en un `<title>`, poner `aria-label` en un SVG que no tiene rol, dar a un icono y a su botón dos nombres distintos, dejar expuestos los SVG decorativos, o usar un SVG de texto en lugar de texto real.

## Cómo comprobar un SVG accesible



## Preguntas frecuentes

Q: ¿Cómo añado texto alternativo a un SVG?
A: Para `<img src="file.svg">`, use el atributo `alt` como en cualquier imagen. Para un `<svg>` en línea, añada `role="img"` y bien `aria-label="…"`, bien `aria-labelledby` que apunte a un `<title>` dentro del SVG.

Q: ¿Deben los iconos SVG llevar aria-hidden?
A: Sí, cuando el icono está junto a un texto visible o dentro de un enlace o un botón que ya tiene nombre. Entonces el icono se oculta con `aria-hidden="true"` y el control lleva el nombre. Un icono independiente que transmite información necesita, en cambio, su propio nombre.

Q: ¿Un logotipo en SVG necesita texto alternativo?
A: Sí, un logotipo tiene significado, normalmente el nombre de la empresa. Si el logotipo es además el enlace a la página de inicio, ponga el nombre al enlace, por ejemplo «Panadería Acme: inicio», y oculte el SVG que contiene.

Q: ¿Cómo hago accesible un gráfico en SVG?
A: Dele un nombre corto con `role="img"` y ofrezca toda la información en texto: una descripción junto al gráfico o una tabla de datos. El W3C lo llama una alternativa textual corta más una larga.

Q: ¿Qué hace focusable="false" en un SVG?
A: Evita que algunos navegadores antiguos incluyan el SVG en el orden de tabulación. Los navegadores modernos no lo necesitan, pero no hace daño en los SVG decorativos ni en los iconos.
