Nombre accesible: qué es y cómo se calcula
También llamado: Etiqueta accesible, Nombre calculado, Nombre programático
Definición
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 es un criterio de nivel A de las 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 prevalece sobre el texto visible. Los escáneres señalan la falta de nombre como botón vacío, enlace vacío, falta de etiqueta de formulario o «Imagen sin texto alternativo».
Ejemplos
<!-- 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>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.
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
¿Qué diferencia hay entre un nombre accesible y una etiqueta?
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.
¿De dónde sale el nombre accesible de un botón?
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.
¿Puede un nombre accesible ser demasiado largo?
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.
¿Cómo encuentro los elementos sin nombre accesible?
Ejecute el comprobador WCAG gratuito en su página de inicio: detecta los enlaces, botones y campos sin nombre.
¿Puede allyWay corregir automáticamente los nombres accesibles que faltan?
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 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 y compruebe qué elementos nombra allyWay en su sitio web.
Términos relacionados
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 corregirloEnlace vacío: qué significa el error y cómo corregirlo
Un enlace vacío es un elemento de enlace sin nombre accesible: sin texto, sin texto alternativo en una imagen que contenga y sin aria-label. Los lectores de pantalla solo pueden anunciarlo como un simple enlace, así que el usuario no sabe adónde lleva.
Leer la definición: Enlace vacío: qué significa el error y cómo corregirloFalta de etiqueta de formulario: qué es y cómo corregirla
La falta de etiqueta de formulario significa que un campo de entrada, una casilla de verificación, una lista desplegable o un área de texto no tiene ninguna etiqueta asociada por software ni otro nombre accesible. Los lectores de pantalla solo anuncian el tipo de campo, así que los usuarios no saben qué deben introducir.
Leer la definición: Falta de etiqueta de formulario: qué es y cómo corregirlaaria-label: cómo nombrar correctamente los elementos
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.
Leer la definición: aria-label: cómo nombrar correctamente los elementos