Botón vacío: qué significa el error y cómo corregirlo
También llamado: Botón sin texto, Botón sin nombre accesible, Botón sin nombre
Definición
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.
Un botón vacío es un botón que no tiene nombre accesible, por lo que un lector de pantalla no puede decir qué hace. Los escáneres lo señalan como «Botón vacío» («Empty button») o «El botón no tiene nombre accesible» («Button has no accessible name»). Los sospechosos habituales son los botones con un solo icono: la lupa de búsqueda, el menú de hamburguesa, la «×» para cerrar una ventana emergente y las flechas de un carrusel.
Qué significa
Los usuarios videntes deducen la función de un botón por su icono. Un lector de pantalla necesita texto. Sin nombre, solo anuncia «botón», y el usuario tiene que activarlo para saber qué ocurre, que puede ser tanto «eliminar» como «siguiente». Los usuarios de control por voz tienen el mismo problema: no pueden decir «hacer clic en Buscar» si el botón no tiene ningún nombre que coincida.
El criterio WCAG 4.1.2 Nombre, función, valor es de nivel A en las WCAG 2.2. Exige que el nombre y el rol de cada componente de la interfaz de usuario puedan determinarse por software. Un <button> nativo ya tiene el rol correcto: solo falla cuando no tiene nombre. El W3C recoge este caso como fallo F68: un control sin nombre determinado por software. Los nombres pueden ser visibles o invisibles, pero el W3C señala que, en muchos casos, la etiqueta visible y el nombre deberían coincidir.
| Contenido del botón | Origen del nombre | Resultado |
|---|---|---|
<button>Search</button> |
Texto dentro del botón | Cumple |
Icono + aria-label="Search" |
aria-label | Cumple |
<img alt="Search"> en su interior |
Texto alternativo de la imagen | Cumple |
| Solo icono, sin etiqueta | – | Botón vacío |
<img> sin alt, o alt="" |
– | Botón vacío |
Ejemplos
<!-- Empty button: icon only -->
<button class="close"><svg aria-hidden="true">…</svg></button>
<!-- Fixed: accessible name with aria-label -->
<button class="close" aria-label="Close dialog"><svg aria-hidden="true">…</svg></button>
<!-- Fixed: image with alt text -->
<button type="submit"><img src="search.svg" alt="Search"></button>Las imágenes usadas como contenido de un botón necesitan una alternativa textual, así que la falta del atributo alt en esa imagen también crea un botón vacío.
Indique la acción con una o dos palabras: «Buscar», «Abrir menú», «Cerrar diálogo», «Siguiente diapositiva». Oculte los iconos decorativos dentro de un botón con nombre mediante aria-hidden="true".
Usar un div o un span con aspecto de botón y sin rol ni nombre, depender únicamente de un tooltip o de title, o dar el mismo nombre a todos los botones de icono («botón», «icono»).
Cómo corregir un botón vacío
Los widgets de los temas y los constructores de páginas suelen generar botones vacíos. Si usa Shopify, revise primero los controles del carrito, de la búsqueda y de los carruseles.
Preguntas frecuentes
¿Qué es un botón vacío?
Un botón sin nombre accesible. Los lectores de pantalla anuncian «botón», pero no lo que hace.
¿Basta con aria-label para corregir un botón vacío?
Sí: en los botones con un solo icono, aria-label es una técnica suficiente (ARIA14). Si el botón muestra texto visible, el nombre debe contener ese texto, para que los usuarios de control por voz puedan decir lo que ven.
¿Cuenta un atributo title como nombre de un botón?
Los navegadores pueden usar title como nombre en último recurso, pero no es una buena forma de corregirlo: no se muestra en los dispositivos táctiles ni a los usuarios de teclado. Es preferible aria-label o un texto visible.
¿Cómo encuentro botones vacíos en mi sitio web?
Ejecute el comprobador WCAG gratuito en su página de inicio. Señala los botones vacíos junto con problemas relacionados, como una etiqueta de formulario que falta.
¿Puede allyWay corregir automáticamente los botones vacíos?
Sí. allyWay detecta los botones sin nombre en todo su sitio web y les da nombres claros que los lectores de pantalla pueden leer en voz alta, redactados por la IA a partir del contenido de sus páginas. Las correcciones automáticas las aplica el script de allyWay, sin cambios en su tema ni en su código, y cualquier corrección se puede deshacer con un clic. Empiece gratis y vea qué botones nombra allyWay en su sitio web.
Términos relacionados
Enlace 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 corregirlaFalta el atributo alt: el error explicado y corregido
La falta del atributo alt significa que un elemento img (o un botón de imagen o un área de mapa de imagen) no tiene ningún atributo alt. Las tecnologías de apoyo no pueden saber si la imagen es informativa o decorativa y pueden leer en voz alta el nombre del archivo.
Leer la definición: Falta el atributo alt: el error explicado y corregidoBotó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 accesible