¿Cómo de accesible es su sitio web?Comprobar gratis
WCAG 1.1.1Nivel APerceptible

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

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. 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.

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.

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

    ¿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.

    • 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 alternativo
    • Imá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 accesible
    • Nombre 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

    Deje que la IA se ocupe de la accesibilidad web

    Hecho en Europa. Se instala en 2 minutos, sin necesidad de desarrolladores. Ponga la accesibilidad de su sitio web en piloto automático con correcciones con IA y monitorización automática.

    1. 1Elija su plan
    2. 2Instalación en 2 min
    3. 3Deje que la IA corrija su sitio web
    4. Listo