Saltar al contenido

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

html

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-label se 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.

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 su aria-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.