# Botón de icono: cómo darle un nombre accesible

Source: https://allyway.ai/es/glossary/boton-de-icono

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.

Un botón de icono es un botón que muestra un símbolo en lugar de una palabra: la lupa que abre la búsqueda, la «×» que cierra un cuadro de diálogo, el corazón que guarda un producto. Los botones que solo tienen icono ahorran espacio, pero el símbolo es invisible para un lector de pantalla: el botón necesita en el código un nombre que diga qué hace.

## 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). Para cada componente de la interfaz de usuario, el nombre y el rol deben poder determinarse por software. Un `<button>` nativo aporta el rol. Del nombre se encarga usted, y un icono por sí solo no lo proporciona. Cuando falta, los escáneres informan de un [botón vacío](https://allyway.ai/es/glossary/boton-vacio), y el W3C lo clasifica como fallo F68: un control sin un nombre determinado por software.

El W3C distingue dos ideas. Una *etiqueta* es visible para todos; un *nombre* es lo que lee el software y puede estar oculto. Los controles de icono son el caso clásico de un nombre sin etiqueta visible. Por eso un mismo botón de símbolo puede cumplir el criterio o no según un único atributo.

Hay cuatro formas fiables de dar nombre a un control de icono:

| Técnica | Código | Ideal para |
|---|---|---|
| `aria-label` (ARIA14) | `<button aria-label="Search">` | La mayoría de los botones de icono |
| Texto oculto visualmente | texto con una clase `sr-only` dentro del botón | Texto que también debe traducirse bien |
| `aria-labelledby` (ARIA16) | apunta al `id` de un texto visible | Botones situados junto a un encabezado o una etiqueta existentes |
| Imagen con texto alternativo | `<img src="search.svg" alt="Search">` | Botones que contienen un `<img>` |

> **Tip:** > **Describa la acción, no la imagen**
> «Cerrar cuadro de diálogo» ayuda; «X» o «icono de cruz», no. Si el icono cambia el estado de algo, mantenga el nombre estable y comunique el estado, por ejemplo con `aria-pressed="true"` en un botón «Silenciar».

Las personas que usan el control por voz dicen lo que ven: «hacer clic en buscar». Elija nombres que coincidan con lo que el icono significa habitualmente, para que funcione la orden hablada. Una [descripción emergente al pasar el cursor](https://allyway.ai/es/glossary/contenido-al-pasar-el-cursor-o-foco) es un buen complemento para los usuarios videntes que utilizan ratón, pero no es el nombre accesible.

## Ejemplos

```html title="Ejemplo"
<!-- Icon button without a name: announced only as "button" -->
<button class="cart"><svg viewBox="0 0 24 24">…</svg></button>

<!-- Fixed with aria-label; the decorative SVG is hidden -->
<button class="cart" aria-label="Open cart">
  <svg viewBox="0 0 24 24" aria-hidden="true" focusable="false">…</svg>
</button>

<!-- Fixed with visually hidden text -->
<button class="menu">
  <svg aria-hidden="true">…</svg>
  <span class="sr-only">Open menu</span>
</button>
```

Cuando el icono es un `<img>`, su texto alternativo se convierte en el nombre del botón. Por eso, si a esa imagen le [falta el atributo alt](https://allyway.ai/es/glossary/falta-atributo-alt), el botón se queda sin nombre, y lo mismo ocurre con los enlaces de icono, que entonces aparecen como un [enlace vacío](https://allyway.ai/es/glossary/enlace-vacio).

**Do:** Qué hacer

Utilice un `<button>` real, póngale un nombre de acción corto, oculte el SVG o la fuente de iconos con `aria-hidden="true"` y use el mismo nombre para la misma acción en todo el sitio.

**Don't:** Qué evitar

Poner el icono en un `div` con acción de clic, confiar en `title` o en una descripción emergente al pasar el cursor como único nombre, o dejar que un glifo de la fuente de iconos se lea como un carácter cualquiera.

## Cómo comprobar un botón de icono



## Preguntas frecuentes

Q: ¿Qué es un botón de icono en accesibilidad?
A: Un botón que muestra solo un símbolo y ningún texto visible. Es accesible cuando tiene un nombre accesible en el código, por ejemplo mediante `aria-label` o texto oculto visualmente, que describa la acción.

Q: ¿Es mejor aria-label o texto oculto visualmente para un botón de icono?
A: Ambos son válidos. `aria-label` es rápido y está cubierto por la técnica ARIA14. El texto oculto visualmente es texto normal de la página, así que las herramientas de traducción lo recogen con más fiabilidad. Elija un enfoque y utilícelo de forma coherente.

Q: ¿Debe tener un título el SVG de un botón de icono?
A: No, si el botón ya tiene nombre. Oculte el SVG con `aria-hidden="true"`; de lo contrario, algunos lectores de pantalla anuncian también el gráfico y el nombre puede leerse dos veces.

Q: ¿Cómo encuentro los botones de icono sin nombre en mi sitio web?
A: Analice sus páginas clave con el [comprobador WCAG gratuito](https://allyway.ai/es/free-wcag-accessibility-scanner-for-websites). Detecta los botones y los enlaces sin nombre accesible, así que verá todos los iconos sin etiqueta en una sola lista.

Q: ¿Puede allyWay corregir automáticamente los botones de icono?
A: Sí. allyWay detecta los botones de icono sin nombre en todo su sitio y les da nombres claros que los lectores de pantalla leen 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é iconos nombra allyWay en su sitio.
