# Etiqueta en el nombre: el texto visible en el nombre

Source: https://allyway.ai/es/glossary/etiqueta-en-el-nombre

Etiqueta en el nombre es el criterio de conformidad 2.5.3 de las WCAG (nivel A). En los componentes de la interfaz de usuario con etiquetas que incluyen texto o imágenes de texto, el nombre accesible contiene el texto que se presenta visualmente.

Etiqueta en el nombre significa que las palabras que las personas ven en un botón, un enlace o un campo forman parte también del nombre que lee el software. Un botón muestra «Enviar», pero su código dice `aria-label="Submit form"`: una persona que usa control por voz dice «Pulsar Enviar» y no ocurre nada. El criterio WCAG 2.5.3 cierra esa brecha entre la etiqueta visible y el nombre accesible.

## Qué significa

El criterio [WCAG 2.5.3 Etiqueta en el nombre](https://www.w3.org/WAI/WCAG22/Understanding/label-in-name.html) es de nivel A: en los componentes de la interfaz de usuario con etiquetas que incluyen texto o imágenes de texto, el nombre contiene el texto que se presenta visualmente. La intención, según el W3C, es que las palabras que etiquetan visualmente un componente sean también las palabras asociadas a él por software.

| Etiqueta visible | Nombre accesible | Resultado |
|---|---|---|
| Buscar | Buscar | Cumple: el nombre coincide con la etiqueta |
| Buscar | Buscar un valor | Cumple: el nombre empieza por la etiqueta |
| Nombre de pila: | Primer nombre | Incumple: palabras distintas |
| Enviar | Remitir formulario | Incumple: falta la palabra visible |

El W3C añade algunas precisiones: por lo general se ignoran las mayúsculas y la mayor parte de la puntuación, los caracteres simbólicos como una «B» en un botón de negrita no son etiquetas, y los componentes sin etiqueta de texto visible quedan fuera del ámbito del criterio. Un texto de marcador de posición (placeholder) cuenta como etiqueta solo cuando no hay ningún otro texto cercano que cumpla esa función.

Quiénes se benefician: las personas que usan control por voz, que activan los controles diciendo la etiqueta que ven, y los usuarios de [lectores de pantalla](https://allyway.ai/es/glossary/lector-de-pantalla) que ven la pantalla, que oyen nombres coincidentes con el texto que tienen delante.

> **Tip:** > **Ponga primero el texto visible**
> El W3C considera una buena práctica que el [nombre accesible](https://allyway.ai/es/glossary/nombre-accesible) empiece por el texto de la etiqueta. «Buscar un valor» funciona, pero «Buscar» a secas es aún más fácil de reconocer. Cuantas más palabras añada, más conviene preguntarse si hacen falta.

## Ejemplos

```html title="Ejemplo"
<!-- Fails: aria-label replaces the visible text "Send" -->
<button type="submit" aria-label="Submit form">Send</button>

<!-- Passes: no aria-label, the visible text is the name -->
<button type="submit">Send</button>

<!-- Passes: the name starts with the visible text -->
<a href="/report.pdf" aria-label="Read more about the 2026 annual report">Read more</a>

<!-- Passes: the label element gives the field its name -->
<label for="email">Email address</label>
<input id="email" type="email" autocomplete="email">
```

La causa más habitual de los fallos es un [aria-label](https://allyway.ai/es/glossary/aria-label) que sustituye al texto visible. El W3C aconseja tener cuidado con `aria-label` y `aria-labelledby` cuando ya existe una etiqueta visible. En los campos, un elemento `<label>` real es la opción más segura; consulte las [etiquetas de formulario](https://allyway.ai/es/glossary/etiquetas-de-formulario).

**Do:** Qué hacer

Deje que el texto visible sea el nombre siempre que pueda, haga que cualquier nombre más largo empiece por las palabras visibles exactas, mantenga las abreviaturas y las fórmulas tal como están escritas y use un elemento `<label>` en cada campo.

**Don't:** Qué evitar

Añadir un `aria-label` con palabras distintas a un botón que ya tiene texto, etiquetar un enlace como «Más información» mientras su nombre dice «Detalles del producto», o reescribir el texto visible en el nombre por motivos de «SEO».

## Cómo comprobar la etiqueta en el nombre



## Preguntas frecuentes

Q: ¿Cuál es la diferencia entre una etiqueta y un nombre accesible?
A: La etiqueta es el texto que las personas ven junto a un control o dentro de él. El nombre accesible es lo que el software, como los lectores de pantalla y el control por voz, usa para identificarlo. El criterio WCAG 2.5.3 pide que el nombre contenga la etiqueta visible.

Q: ¿Tiene que coincidir exactamente el nombre accesible con la etiqueta?
A: No. Debe contener el texto visible. El W3C recomienda que coincidan siempre que sea práctico y que, si añade más palabras, el nombre empiece por el texto de la etiqueta.

Q: ¿Importan las mayúsculas o la puntuación?
A: Por lo general no. El W3C señala que para este criterio se ignoran las mayúsculas y la mayor parte de la puntuación, pero recomienda conservar las mayúsculas cuando indican una abreviatura.

Q: ¿Se aplica Etiqueta en el nombre a los botones de icono?
A: No, si el icono no tiene texto visible. Un botón con solo un símbolo no tiene etiqueta de texto, así que el criterio no se aplica; aun así, necesita un nombre accesible claro según otros criterios.
