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
<!-- 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>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".
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.
Términos relacionados
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 calculaARIA: 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 explicadosBotó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 accesibleBotó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