# aria-label: cómo nombrar correctamente los elementos

Source: https://allyway.ai/es/glossary/aria-label

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](https://allyway.ai/es/glossary/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](https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html) (nivel A, [WCAG 2.2](https://allyway.ai/es/regulations/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.

> **Tip:** > **Primero, las palabras visibles**
> Si un control muestra texto, el aria-label debe empezar exactamente por esas palabras («Buscar productos» para un botón que dice «Buscar»). El criterio 2.5.3 [Etiqueta en el nombre](https://allyway.ai/es/glossary/etiqueta-en-el-nombre), del W3C, exige que el nombre contenga el texto visible y recomienda ponerlo al principio, para que los usuarios de control por voz puedan decir lo que ven.

## Ejemplos

```html title="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>
```

**Do:** Qué hacer

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

**Don't:** 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

Q: ¿Qué diferencia hay entre aria-label y aria-labelledby?
A: 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.

Q: ¿aria-label sustituye al texto visible de un enlace?
A: 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.

Q: ¿aria-label sirve para el SEO?
A: 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.

Q: ¿Puedo usar aria-label en un div?
A: 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.

Q: ¿Cómo encuentro los iconos sin nombre en mi sitio web?
A: El [comprobador WCAG gratuito](https://allyway.ai/es/free-wcag-accessibility-scanner-for-websites) revisa su página de inicio según las WCAG 2.2 AA, incluidos los enlaces y botones sin nombre accesible.
