SVG accesible: texto alternativo para iconos y logotipos
También llamado: Iconos SVG accesibles, Texto alternativo de SVG, Accesibilidad de SVG en línea
Definición
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 (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). Lo difícil es el <svg> en línea, porque los navegadores no lo tratan como una imagen por defecto.
Ejemplos
<!-- 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. En el botón de búsqueda, el SVG permanece en silencio y el aria-label pasa a ser el nombre accesible del botón; sin él tendría un botón de icono que no dice nada. focusable="false" evita que los navegadores antiguos incluyan el SVG en el orden de tabulación.
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.
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
¿Cómo añado texto alternativo a un SVG?
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.
¿Deben los iconos SVG llevar aria-hidden?
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.
¿Un logotipo en SVG necesita texto alternativo?
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.
¿Cómo hago accesible un gráfico en SVG?
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.
¿Qué hace focusable="false" en un SVG?
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.
Términos relacionados
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.
Leer la definición: Texto alternativoImágenes decorativas: cuándo usar alt=""
Las imágenes decorativas son imágenes puramente ornamentales o usadas solo para dar formato visual, que no aportan información a la página. El criterio WCAG 1.1.1 exige que se implementen de forma que las tecnologías de apoyo puedan ignorarlas, por ejemplo con un atributo alt vacío o como fondo CSS.
Leer la definición: Imágenes decorativas: cuándo usar alt=""Botón de icono: cómo darle un nombre accesible
Un botón de icono es un botón que muestra solo un símbolo (una lupa, una cruz, tres rayas) y ningún texto visible. Para ser accesible necesita un nombre accesible en el código que indique a las tecnologías de apoyo qué hace el botón.
Leer la definición: Botón de icono: cómo darle un nombre accesibleNombre accesible: qué es y cómo se calcula
El nombre accesible es el texto que los navegadores transmiten a las tecnologías de apoyo para identificar un elemento, por ejemplo las palabras que un lector de pantalla anuncia para un botón, un enlace o un campo de formulario. El criterio WCAG 4.1.2 exige que todo componente de la interfaz de usuario tenga un nombre que pueda determinarse por software.
Leer la definición: Nombre accesible: qué es y cómo se calcula