¿Cómo de accesible es su sitio web?Comprobar gratis
WCAG 1.4.13Nivel AAPerceptible

Tooltip accesible: cursor, foco y Escape

También llamado: Pista accesible, Burbuja de información, Tooltip ARIA, Toggletip

Definición

Un tooltip accesible es una pequeña ventana emergente con información adicional sobre un elemento que aparece al pasar el ratón y con el foco del teclado, está vinculada a su elemento activador con aria-describedby y cumple el criterio WCAG 1.4.13 Contenido señalado con el puntero o que tiene el foco, de nivel AA: se puede descartar, se puede señalar con el puntero y sigue visible hasta que el usuario se aleja.

Un tooltip accesible es una pequeña burbuja de texto que explica un control («Copiar enlace», «Obligatorio para las facturas», una pista junto a un campo de formulario) y que todos pueden leer y descartar. Muchos tooltips solo se abren al pasar el ratón, desaparecen en cuanto el puntero se mueve hacia ellos o tapan justo el texto que las personas intentan leer. Para los usuarios de teclado, de ampliadores de pantalla y de pantallas táctiles, eso significa que la pista es inalcanzable o estorba.

Qué significa

Las reglas visuales proceden del criterio WCAG 1.4.13 Contenido señalado con el puntero o que tiene el foco (nivel AA). Siempre que el paso del cursor o el foco del teclado haga aparecer contenido adicional, se aplican tres condiciones, explicadas con detalle en contenido al pasar el cursor o con foco:

Condición Qué exige
Descartable Los usuarios pueden cerrar el tooltip sin mover el puntero ni el foco, normalmente con Escape, salvo que muestre un error de entrada o no tape otro contenido
Señalable con el puntero Si se abre al pasar el cursor, el puntero puede moverse sobre el tooltip sin que desaparezca
Persistente Sigue visible hasta que el cursor o el foco se alejan, el usuario lo descarta o su información deja de ser válida

La excepción son los tooltips cuyo aspecto controla el navegador y el autor no modifica. Por eso el atributo nativo title queda fuera del criterio 1.4.13, pero solo se muestra al pasar el ratón, no con el foco del teclado ni al tocar la pantalla, de modo que es un mal lugar para la información importante.

En cuanto al código, el patrón de tooltip del W3C describe lo básico (todavía figura como trabajo en curso):

  • la ventana emergente tiene role="tooltip"
  • el elemento activador apunta a ella con aria-describedby, de modo que los lectores de pantalla la leen como una descripción
  • el foco permanece en el elemento activador: un tooltip nunca recibe el foco
  • Escape lo cierra

Ejemplos

Ejemplo
<button type="button" aria-label="Copy link"
        aria-describedby="tip-copy">
  <svg aria-hidden="true" focusable="false">…</svg>
</button>
<div role="tooltip" id="tip-copy" hidden>
  Copies the address of this page to your clipboard
</div>

El script muestra el tooltip con mouseenter y focus, lo mantiene abierto mientras el puntero está sobre el botón o sobre el tooltip y lo oculta con mouseleave, blur y Escape. El botón de icono tiene su propio nombre, así que un lector de pantalla anuncia «Copy link, botón, Copies the address of this page to your clipboard».

Qué hacer

Abra el tooltip al pasar el cursor y con el foco del teclado, deje que Escape lo cierre, manténgalo abierto mientras el puntero está sobre él, colóquelo de forma que no tape el elemento activador y mantenga su texto breve.

Qué evitar

Poner instrucciones esenciales solo en un tooltip, depender del atributo title para los usuarios de teclado o de pantalla táctil, cerrarlo tras un tiempo fijo, añadirle enlaces o botones, o usar un tooltip como único nombre de un botón de icono.

Para contenido con enlaces o explicaciones más largas, use un toggletip (un pequeño botón que abre la pista con un clic) o muestre el texto directamente en la página.

Cómo comprobar un tooltip accesible

    Preguntas frecuentes

    ¿Cómo se hace accesible un tooltip?

    Muéstrelo al pasar el cursor y con el foco del teclado, vincúlelo con aria-describedby, dé a la ventana emergente role="tooltip", ciérrelo con Escape y manténgalo abierto mientras el puntero está sobre él. La información importante debe estar en la página, no solo en un tooltip.

    ¿Es accesible el atributo title?

    Queda fuera del criterio WCAG 1.4.13 porque el navegador controla su aspecto. Pero solo aparece al pasar el ratón, así que los usuarios de teclado y de pantalla táctil normalmente no lo ven nunca. No lo use para nada esencial.

    ¿Debe un tooltip cerrarse con Escape?

    Sí. El criterio WCAG 1.4.13 exige una forma de descartar el contenido adicional sin mover el puntero ni el foco, y el patrón de tooltip del W3C usa Escape para ello.

    ¿Puede un tooltip contener enlaces o botones?

    Un tooltip nunca recibe el foco, así que las personas no podrían llegar al contenido interactivo que tuviera. Use en su lugar un toggletip o un cuadro de diálogo no modal.

    ¿Cómo funcionan los tooltips en el móvil?

    En las pantallas táctiles no se puede pasar el cursor por encima. Asegúrese de que la información esté disponible de otra forma: como texto visible o detrás de un botón que la abra al tocarlo.

    • Contenido al pasar el cursor o con foco: tooltips correctos

      El contenido al pasar el cursor o con foco es el criterio de conformidad WCAG 1.4.13. Cuando el cursor o el foco del teclado hacen aparecer contenido adicional (una descripción emergente personalizada, un submenú o una ventana emergente), este debe poder cerrarse sin mover el cursor ni el foco, poder señalarse con el cursor y mantenerse visible hasta que la persona termine.

      Leer la definición: Contenido al pasar el cursor o con foco: tooltips correctos
    • Botó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
    • Nombre accesible: qué es y cómo se calcula

      El nombre accesible es el texto que los navegadores transmiten a las tecnologías de apoyo para identificar un elemento, por ejemplo las palabras que un lector de pantalla anuncia para un botón, un enlace o un campo de formulario. El criterio WCAG 4.1.2 exige que todo componente de la interfaz de usuario tenga un nombre que pueda determinarse por software.

      Leer la definición: Nombre accesible: qué es y cómo se calcula
    • Baja visión: qué implica para el diseño web

      La baja visión es una discapacidad visual distinta de la ceguera que las gafas o las lentes de contacto no corrigen del todo, como la visión borrosa, la pérdida de visión central o lateral, la sensibilidad a la luz o la menor sensibilidad al contraste. La mayoría de las personas con baja visión leen los sitios web con los ojos, a menudo con zoom, ampliación o colores personalizados.

      Leer la definición: Baja visión: qué implica para el diseño web

    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