# Botón vacío: qué significa el error y cómo corregirlo

Source: https://allyway.ai/es/glossary/boton-vacio

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

> **Note:** > **El mismo error en otro elemento**
> Un [enlace vacío](https://allyway.ai/es/glossary/enlace-vacio) y un botón vacío tienen la misma causa y la misma corrección. La diferencia: los enlaces llevan a algún sitio y los botones hacen algo en la página.

## Ejemplos

```html title="Ejemplo"
<!-- 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](https://allyway.ai/es/glossary/falta-atributo-alt) en esa imagen también crea un botón vacío.

**Do:** Qué hacer

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"`.

**Don't:** Qué evitar

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](https://allyway.ai/es/integrations/shopify-accessibility-integration), revise primero los controles del carrito, de la búsqueda y de los carruseles.

## Preguntas frecuentes

Q: ¿Qué es un botón vacío?
A: Un botón sin nombre accesible. Los lectores de pantalla anuncian «botón», pero no lo que hace.

Q: ¿Basta con aria-label para corregir un botón vacío?
A: 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.

Q: ¿Cuenta un atributo title como nombre de un botón?
A: 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.

Q: ¿Cómo encuentro botones vacíos en mi sitio web?
A: Ejecute el [comprobador WCAG gratuito](https://allyway.ai/es/free-wcag-accessibility-scanner-for-websites) en su página de inicio. Señala los botones vacíos junto con problemas relacionados, como una [etiqueta de formulario que falta](https://allyway.ai/es/glossary/falta-etiqueta-de-formulario).

Q: ¿Puede allyWay corregir automáticamente los botones vacíos?
A: 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](https://allyway.ai/es/automatic-accessibility-fixes-for-website) 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](https://app.allyway.ai/register) y vea qué botones nombra allyWay en su sitio web.
