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
<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».
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.
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.
Términos relacionados
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 correctosBotó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 accesibleNombre 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 calculaBaja 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