Saltar al contenido
Índice de Kit UI
Kit UI Componentes

Spinner.

Patrón canónico de spinner para todos los consumidores.

Verlo por niveles

Primero el componente, después la variación de marca y finalmente su uso dentro de una página.

Nivel 1Componente canónico
Cargando resultados
Nivel 2COCHID · variación
Reintentando conexión
Nivel 3Dentro de una página
Sitio · sección
Cargando resultados
Ver y copiar el código de este render
HTML del nivel canónico
<div class="ui-sample ui-spinner-frame" data-spinner role="status"><span class="ui-spinner" aria-hidden="true"></span><span>Cargando resultados</span></div>

Variaciones por marca y sitio

Cada cambio visible declara su autoridad; lo que permanece canónico no se vuelve a inventar en el producto.

innovacionsantiago.cl

Compañía de Innovación de Santiago

Autoridad: CONSTITUTION.md + LOGOS-CANONICOS.md
Cargando resultados

Cambia en esta marca

  • Navegación y contenido propios del servicio
  • Acento reservado para acciones y datos

Permanece canónico

  • Mark CIS y namebrand de tres líneas
  • IBM Plex Sans, foco, espaciado y anatomía
cochid.cl

COCHID

Autoridad: core-style/DECISIONES.md M15 y LOGOS-CANONICOS.md
Reintentando conexión

Cambia en esta marca

  • Cuadrado azul y namebrand de tres líneas
  • Azul COCHID en selección, capas y series

Permanece canónico

  • Estructura y semántica comunes
  • Fuentes, unidades y alternativa tabular

Comparación histórica recuperable

Compara la propuesta con cortes reales del repositorio. La ausencia de una muestra se declara y nunca se reconstruye de memoria.

Estado actual
Spinner tiene 1 implementaciones observadas en 1 repositorios: cds/cis/cis-usaia.
Cambio propuesto
Publicar en r19 el contrato de Spinner para Patrón canónico de spinner para todos los consumidores.
Qué ocurre si respondes No
No se adopta el contrato r19 de Spinner; las 1 implementaciones observadas permanecen sin migración.

Preparando comparación histórica…

Antes / r19

La comparación convierte una regla abstracta en una diferencia visible y verificable.

r19 · correctoContrato canónico renderizado
Cargando resultados
  • Usa HTML semántico, foco visible y estados explícitos.
  • Conserva contenido útil a 320 px y sin JavaScript.
Antes · problema observadoAnti-ejemplo no interactivo
EN LÍNEATodo funciona correctamenteSin señal, hora ni servicio asociado
  • No agregues sombras, radios ni franjas laterales decorativas.
  • No uses color, placeholder o icono como única explicación.

Responsive

La misma anatomía debe conservar lectura, foco y acciones sin cortar contenido ni crear scroll horizontal en la página.

320 pxMóvil y zoom
Cargando resultados
1280 pxEscritorio
Reintentando conexión

Cobertura

DimensiónContrato
Propietario canónicoSistema de diseño CIS · core/core-style
ConsumidoresTodos los consumidores
DependenciasHTML nativo, ARIA sólo cuando aporta
Estadocandidato

Evidencia de adopción

Patrón observado. 1 implementaciones observadas en 1 repositorios.

La observación demuestra uso existente; la aceptación canónica sigue dependiendo de esta ficha y de su propietario.

DatoResultado
ClasificaciónPatrón observado
Implementaciones1 implementaciones observadas
Repositorioscds/cis/cis-usaia
Snapshotkit/componentes/componentes-observados.json

Consumidores observados

El inventario conserva repositorio, archivo fuente y criterio de asociación. Observar una implementación no la convierte automáticamente en canónica.

Estados

Estado requerido
información
advertencia
error
éxito

Accesibilidad

  • Conserva nombre accesible, orden de lectura y foco visible.
  • Funciona a 320 px, con zoom de 200% y texto largo.
  • El color nunca es la única señal de estado o acción.
  • El contenido esencial permanece disponible sin JavaScript.

Código HTML

Copia el bloque completo; después cambia contenido y destinos, no su anatomía.

Código de referencia
<div class="ui-sample ui-spinner-frame" data-spinner role="status"><span class="ui-spinner" aria-hidden="true"></span><span>Cargando resultados</span></div>

Código TAILWIND

Copia el bloque completo; después cambia contenido y destinos, no su anatomía.

Código de referencia
<div class="ui-sample ui-spinner-frame border border-slate-300 bg-white p-4 text-slate-950" data-spinner role="status"><span class="ui-spinner" aria-hidden="true"></span><span>Cargando resultados</span></div>

Código REACT

Copia el bloque completo; después cambia contenido y destinos, no su anatomía.

Código de referencia
export interface SpinnerProps {
  /** Qué se está esperando, en gerundio («Cargando resultados»); vacío omite el texto. */
  label?: string;
  className?: string;
}

/**
 * Indicador de carga con texto, para una espera breve cuyo avance no se puede medir.
 *
 * Usa `role="status"`. El círculo es decorativo (`aria-hidden`): el texto dice qué se espera. Si el avance se puede medir, usa `ProgressBar`.
 *
 * @example <Spinner label="Cargando resultados" />
 * @example <Spinner label="Reintentando conexión" />
 */
export function Spinner({ label = "Cargando resultados", className }: SpinnerProps) {
  return (
    <div className={["ui-spinner-frame", className].filter(Boolean).join(" ")} data-spinner role="status">
      <span className="ui-spinner" aria-hidden="true"></span>
      {label ? <span>{label}</span> : null}
    </div>
  );
}