# Nombre accesible: qué es y cómo se calcula

Source: https://allyway.ai/es/glossary/nombre-accesible

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.

Un nombre accesible es el texto que un navegador entrega a las tecnologías de apoyo para identificar un enlace, un botón, un campo de formulario u otro control. Un lector de pantalla lo lee en voz alta («Buscar, botón») y el software de control por voz compara con él los comandos pronunciados. Sin nombre accesible, un control se anuncia solo por su rol, y las personas tienen que adivinar para qué sirve.

## Qué significa

[WCAG 4.1.2 Nombre, función, valor](https://www.w3.org/WAI/WCAG22/Understanding/name-role-value.html) es un criterio de nivel A de las [WCAG 2.2](https://allyway.ai/es/regulations/wcag-2-2). Exige que el nombre y el rol de todo componente de la interfaz de usuario (elementos de formulario, enlaces y componentes generados por scripts) puedan determinarse por software. El W3C señala que el nombre puede estar oculto, pero que, cuando es visible, se denomina etiqueta. Un control sin nombre determinable por software figura como fallo F68.

El navegador calcula el nombre a partir de varias fuentes y toma la primera que existe. En orden simplificado:

| Prioridad | Fuente | Ejemplo |
|---|---|---|
| 1 | `aria-labelledby` (texto del elemento al que hace referencia) | `<button aria-labelledby="t1">` |
| 2 | `aria-label` | `<button aria-label="Close">` |
| 3 | Etiquetado nativo | `<label for>`, `alt` en imágenes, `<caption>`, `<legend>` |
| 4 | Contenido de texto (enlaces, botones, encabezados) | `<a href="/cart">Cart</a>` |
| 5 | `title` o `placeholder` como último recurso | `<input title="Search">` |

Por eso un elemento puede tener texto visible y, aun así, un nombre distinto: un [aria-label](https://allyway.ai/es/glossary/aria-label) prevalece sobre el texto visible. Los escáneres señalan la falta de nombre como [botón vacío](https://allyway.ai/es/glossary/boton-vacio), [enlace vacío](https://allyway.ai/es/glossary/enlace-vacio), [falta de etiqueta de formulario](https://allyway.ai/es/glossary/falta-etiqueta-de-formulario) o «Imagen sin texto alternativo».

> **Note:** > **Primero, la etiqueta visible**
> El fallo F111 del W3C se refiere a un control con texto de etiqueta visible pero sin nombre accesible. Y según el criterio 2.5.3 [Etiqueta en el nombre](https://allyway.ai/es/glossary/etiqueta-en-el-nombre), las palabras visibles deben formar parte del nombre, para que los usuarios de control por voz puedan decir lo que ven.

## Ejemplos

```html title="Ejemplo"
<!-- No accessible name: announced as "button" only -->
<button><svg aria-hidden="true">…</svg></button>

<!-- Name from aria-label -->
<button aria-label="Open menu"><svg aria-hidden="true">…</svg></button>

<!-- Name from a label element -->
<label for="email">Email address</label>
<input id="email" type="email">

<!-- Name from alt text of the only image in a link -->
<a href="/"><img src="logo.svg" alt="allyWay home"></a>
```

**Do:** Qué hacer

Dé a cada control un nombre corto y único que describa su finalidad: «Buscar», «Añadir a la cesta», «Diapositiva siguiente». Utilice texto visible o un `<label>` siempre que pueda y asegúrese de que el nombre empiece por las palabras visibles.

**Don't:** Qué evitar

Basarse solo en `title` o `placeholder`, llamar «botón» o «icono» a todos los iconos, o añadir un aria-label que contradiga el texto visible («Aceptar» en un botón que dice «Enviar»).

## Cómo comprobar el nombre accesible



## Preguntas frecuentes

Q: ¿Qué diferencia hay entre un nombre accesible y una etiqueta?
A: Una etiqueta es texto visible, como un `<label>` junto a un campo. El nombre accesible es lo que reciben las tecnologías de apoyo: a menudo procede de la etiqueta, pero también puede venir de un aria-label, de un texto alternativo o del contenido del elemento.

Q: ¿De dónde sale el nombre accesible de un botón?
A: Normalmente, de su contenido de texto. Si el botón solo contiene un icono, utilice `aria-label` o `aria-labelledby`, o un texto alternativo en una imagen dentro de él. El atributo `title` es solo un último recurso.

Q: ¿Puede un nombre accesible ser demasiado largo?
A: Las WCAG no fijan ningún límite de longitud, pero los nombres largos ralentizan a los usuarios de lectores de pantalla. Limite el nombre a la finalidad del control, en pocas palabras, y ponga la información adicional en una descripción.

Q: ¿Cómo encuentro los elementos sin nombre accesible?
A: Ejecute el [comprobador WCAG gratuito](https://allyway.ai/es/free-wcag-accessibility-scanner-for-websites) en su página de inicio: detecta los enlaces, botones y campos sin nombre.

Q: ¿Puede allyWay corregir automáticamente los nombres accesibles que faltan?
A: Sí. allyWay asigna nombres claros, que los lectores de pantalla pueden leer en voz alta, a los enlaces y botones que no tienen nombre, y añade etiquetas a los campos que no las tienen. La IA redacta unos y otras a partir del contenido de su página. Las [correcciones automáticas](https://allyway.ai/es/automatic-accessibility-fixes-for-website) las aplica el script de allyWay sin modificar su tema ni su código, y cada corrección se puede deshacer con un clic. [Empiece gratis](https://app.allyway.ai/register) y compruebe qué elementos nombra allyWay en su sitio web.
