¿Cómo de accesible es su sitio web?Comprobar gratis
WCAG 4.1.2Nivel ARobusto

aria-label: cómo nombrar correctamente los elementos

También llamado: Atributo ARIA label, Atributo aria-label, Etiqueta invisible

Definición

aria-label es un atributo ARIA que define el nombre accesible de un elemento como una cadena de texto. Los lectores de pantalla anuncian ese nombre en lugar del contenido del elemento, por lo que se usa sobre todo en controles sin texto visible, como los botones de icono.

aria-label es un atributo HTML de la especificación ARIA que da a un elemento un nombre accesible en texto sin formato. Un lector de pantalla lo anuncia; por ejemplo, «Cerrar cuadro de diálogo, botón» para un icono «×». Es la corrección más rápida para los controles sin texto visible y, a la vez, uno de los atributos que más se usan mal cuando ya existe un texto visible.

Qué significa

El criterio WCAG 4.1.2 Nombre, función, valor (nivel A, WCAG 2.2) exige que todo componente de la interfaz de usuario tenga un nombre que pueda determinarse por software. El W3C cita la técnica ARIA14, que consiste en usar aria-label para proporcionar un nombre accesible cuando no se puede utilizar una etiqueta visible, como una forma suficiente de cumplirlo. La formulación importa: aria-label está pensado para los casos en los que no es posible una etiqueta visible.

Tres cosas que conviene saber sobre este atributo:

Hecho Consecuencia
Sustituye al texto propio del elemento <a aria-label="Read more">Shipping terms</a> se anuncia como «Read more»: se ignora el texto visible
aria-labelledby prevalece sobre él Si se definen ambos, el nombre es el texto al que se hace referencia
Es invisible Los usuarios videntes nunca lo ven, así que los errores pasan inadvertidos

Funciona en elementos interactivos (enlaces, botones, campos de formulario), en regiones (landmarks) como <nav> y en role="img". En un simple div o span sin rol, ARIA no permite asignar un nombre y muchos lectores de pantalla ignoran allí la etiqueta.

Ejemplos

Ejemplo
<!-- Good: icon-only button -->
<button aria-label="Close dialog">
  <svg aria-hidden="true">…</svg>
</button>

<!-- Good: two navigations told apart -->
<nav aria-label="Main">…</nav>
<nav aria-label="Footer">…</nav>

<!-- Bad: label contradicts visible text -->
<a href="/shipping" aria-label="Click here">Shipping terms</a>
Qué hacer

Utilice aria-label en los botones de icono, en los campos de búsqueda sin etiqueta visible y para distinguir varias regiones ARIA (landmarks) del mismo tipo. Describa la acción («Abrir menú»), no el icono («Hamburguesa»). Oculte el propio icono con aria-hidden="true".

Qué evitar

Poner aria-label en elementos que ya tienen un buen texto visible, usarlo en un simple div o span, rellenarlo de palabras clave para el SEO o usarlo en lugar de un <label> real en campos de formulario en los que cabe uno.

Cómo comprobar aria-label

    Preguntas frecuentes

    ¿Qué diferencia hay entre aria-label y aria-labelledby?

    aria-label contiene el nombre como texto dentro del atributo. aria-labelledby apunta al id de otro elemento cuyo texto visible se convierte en el nombre. Use aria-labelledby cuando el texto ya esté en la página.

    ¿aria-label sustituye al texto visible de un enlace?

    Sí. Para las tecnologías de apoyo, aria-label sustituye al contenido del elemento. Por eso una etiqueta distinta del texto visible desconcierta a los usuarios de lectores de pantalla y de control por voz.

    ¿aria-label sirve para el SEO?

    No. aria-label es para las tecnologías de apoyo. Las palabras clave ocultas dificultan el uso de la página y no tienen cabida en ella.

    ¿Puedo usar aria-label en un div?

    Solo si el div tiene un rol que permita un nombre, como role="region" o role="img". En un div o span genérico sin rol, ARIA prohíbe asignar un nombre y muchos lectores de pantalla ignoran la etiqueta.

    ¿Cómo encuentro los iconos sin nombre en mi sitio web?

    El comprobador WCAG gratuito revisa su página de inicio según las WCAG 2.2 AA, incluidos los enlaces y botones sin 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
    • ARIA: roles, estados y propiedades explicados

      ARIA (WAI-ARIA, Accessible Rich Internet Applications) es una especificación del W3C de atributos HTML (roles, estados y propiedades) que indican a las tecnologías de apoyo qué es un elemento personalizado, cómo se llama y en qué estado se encuentra.

      Leer la definición: ARIA: roles, estados y propiedades explicados
    • 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
    • Botón vacío: qué significa el error y cómo corregirlo

      Un botón vacío es un elemento button sin nombre accesible: sin texto, sin aria-label y sin texto alternativo en una imagen que contenga. Los lectores de pantalla solo anuncian que es un botón, no lo que hace.

      Leer la definición: Botón vacío: qué significa el error y cómo corregirlo

    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