Interacción
Tooltip
Muestra ayuda breve con hover y foco; no contiene información crítica.
Ejemplo
Vista real construida con los archivos compilados de Ally.
Información breve disponible con foco y hover.
<span class="docs-relative">
<button class="ally-btn" type="button" data-ally-tooltip="page-tooltip-tooltip">Mostrar ayuda</button>
<span id="page-tooltip-tooltip" class="ally-tooltip" role="tooltip" hidden>Información breve disponible con foco y hover.</span>
</span>
Contrato accesible
- Propósito
- Muestra ayuda breve con hover y foco; no contiene información crítica.
- Clases CSS
.ally-tooltipy modificadores de estado documentados.- HTML
- Elemento semántico correspondiente, heading o nombre accesible y controles nativos.
- ARIA
- role="tooltip" asociado con aria-describedby.
- Teclado
- Se muestra con hover y foco; Escape lo oculta.
- Foco
- Foco visible y predecible; overlays devuelven el foco al control que los abrió.
- Estados
- closed, open, active, selected, expanded, disabled y loading según aplique.
- Ally Debug
- Valida estructura, nombres, relaciones, controles y estados detectables dentro del scope.
Estados y variantes
defaultfocusactivedisablederror
Los estados visibles deben acompañarse de texto, atributos nativos o propiedades ARIA; nunca dependen solo del color.
Accesibilidad
Prueba obligatoria: semántica, teclado, foco visible, zoom al 200%, contraste, reduced motion y lector de pantalla.
No hacer
<div class="ally-tooltip">Contenido sin elemento semántico, nombre accesible ni estados asociados.</div>
Un contenedor genérico con una clase visual no reemplaza la semántica, el nombre accesible ni la gestión de estados.