¿Cómo de accesible es su sitio web?Comprobar gratis
WCAG 4.1.2Nivel ARobusto

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

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, el botón se queda sin nombre, y lo mismo ocurre con los enlaces de icono, que entonces aparecen como un enlace vacío.

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.

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

    ¿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.

    • 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 corregirlo
    • 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 corregirlo
    • Falta 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 corregido
    • Texto 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

    Deje que la IA se ocupe de la accesibilidad web

    Hecho en Europa. Se instala en 2 minutos, sin necesidad de desarrolladores. Ponga la accesibilidad de su sitio web en piloto automático con correcciones con IA y monitorización automática.

    1. 1Elija su plan
    2. 2Instalación en 2 min
    3. 3Deje que la IA corrija su sitio web
    4. Listo