Uso
Cuándo usar
- Para indicar que el sistema está procesando una acción cuyo tiempo de resolución es indeterminado.
Cuándo no usar
- Para indicar el progreso de una acción en curso con un tiempo definido predecible, utilizar la Barra de progreso.
- Para acciones inmediatas, como enviar un formulario.
Tipos
Existen distintas variantes de color para el spinner, cada uno con un significado semántico asociado, y no meramente decorativo, que permiten mantener coherencia con el contexto de uso, como estados de carga, éxito o error. En fondos claros, se recomienda utilizar el spinner primario como opción predeterminada.
Tamaños
Hay tres tamaños de spinner: grande, mediano y chico, tanto para dispositivos desktop, tablet y mobile, y su uso depende del espacio disponible en la interfaz.
- Chico: se utiliza en elementos puntuales, como botones o inputs con carga.
- Mediano: es ideal para modales o secciones de la interfaz.
- Grande: se utiliza para pantallas completas o procesos de carga generales.
Patrones de uso
En el componente Botón
Utilizá la variante Loading del componente Botón para indicar que una acción está en progreso y aún no ha finalizado. Para reforzar el significado de la acción se puede configurar la variante de spinner correspondiente con la de cada botón.
En línea con otros componentes
El spinner también puede utilizarse por fuera del botón, por ejemplo para indicar que se está subiendo un archivo.
Como única referencia visual
Una acción particular puede desencadenar la carga de todo el contenido de una página. En este caso, debe utilizarse el spinner grande centrado, para identificar el procesamiento de la acción. Además, debe ir acompañando de una etiqueta descriptiva que sirva de contexto sobre el contenido a cargar.
El spinner se puede colocar sobre un fondo sólido de color blanco o sobre un overlay (grayscale-950 con 35 % de opacidad), ocupando el cuerpo de la página, sin incluir el encabezado (header) del sitio.
Dado que este comportamiento interrumpe la navegación de la persona usuaria, se recomienda minimizar su uso.
La etiqueta debe indicar el estado del proceso, en un lenguaje claro y utilizando verbos en gerundio, como "Cargando solicitud..." o "Procesando el pago...".
No utilizar el spinner para la carga de contenidos multimedia como imágenes o videos. Tampoco utilizar más de 1 spinner a la vez.