Spinner
Indicador de carga circular para esperas cortas sin progreso conocido. Toma el color del texto (currentColor), así que se adapta al contexto donde se ponga.
Avisos y estado · TaishoDS Core, en HTML plano.
Ejemplos
Un ejemplo por caso, funcionando. Cada ejemplo es el HTML de su vista previa: se copia tal cual y, con el CSS y el JS del Core cargados, se ve y funciona igual.
Tres tamaños
Cuándo usarlo
- La operación es corta y no se sabe cuánto va a tardar.
- Hay que ocupar un lugar chico: dentro de un botón, al lado de un título, en una celda.
- Alcanza con decir “esto está trabajando”, sin más detalle.
Cuándo no
- El avance se puede calcular →
progress. - Se está cargando una estructura que después ocupa lugar →
skeleton, que evita el salto de layout. - Es actividad inline en medio de un texto →
loading-dots.
Cómo usarlo
- El
aria-labelse ajusta a lo que se está esperando: es lo que anuncia el lector de pantalla. - Va donde va a aparecer el resultado, para que la espera tenga lugar.
Cómo no usarlo
- No se pone un spinner por pantalla completa si la estructura se puede dibujar con
skeleton. - Un spinner no debe quedar eterno: si falla, se muestra el error.
Relacionados
TaishoDS Core
No necesita JavaScript: es marcado y CSS.
Animación CSS.
Sin build, desde el CDN: taisho.spinner.css, además de taisho.base.css. Con ese archivo alcanza.
Para el funcionamiento general del Core, ver Comportamiento.
Accesibilidad
- Expone
role="status"con suaria-label(por defecto «Cargando») como texto para lectores de pantalla.
Verificación
Qué se probó de verdad. Lo que no se probó lo dice: preferimos un «sin verificar» a una afirmación de más.
- axe WCAG 2.2 A + AA en navegador real, en tema claro y oscuro, antes de cada versión.
- teclado No agrega teclas propias: usa el comportamiento nativo del navegador.
- lector de pantalla Sin verificar con lector de pantalla. Conviene probarlo en la combinación de componentes propia, no sólo aquí, donde cada uno aparece solo y en su estado feliz.