Botón de icono: cómo darle un nombre accesible
También llamado: Botón solo con icono, Control de icono, Botón de símbolo
Definición
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 es un criterio de nivel A de las 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, 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> |
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 es un buen complemento para los usuarios videntes que utilizan ratón, pero no es el nombre accesible.
Ejemplos
<!-- 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, el botón se queda sin nombre, y lo mismo ocurre con los enlaces de icono, que entonces aparecen como un enlace vacío.
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.
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
¿Qué es un botón de icono en accesibilidad?
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.
¿Es mejor aria-label o texto oculto visualmente para un botón de icono?
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.
¿Debe tener un título el SVG de un botón de icono?
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.
¿Cómo encuentro los botones de icono sin nombre en mi sitio web?
Analice sus páginas clave con el comprobador WCAG gratuito. Detecta los botones y los enlaces sin nombre accesible, así que verá todos los iconos sin etiqueta en una sola lista.
¿Puede allyWay corregir automáticamente los botones de icono?
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 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é iconos nombra allyWay en su sitio.
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 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 corregidoTexto alternativo
El texto alternativo es una breve descripción escrita de una imagen. Los lectores de pantalla la leen en voz alta y los navegadores la muestran cuando la imagen no se carga, de modo que las personas que no pueden ver la imagen también captan su significado.
Leer la definición: Texto alternativo