Artefact UI

Search

Blog

Documentation

About

Playground

Modifier

MenuChevron Down

Blog

Documentation

About

Playground

Modifier

Spinner Indicateur de Chargement - Docs - Artefact

Spinner Indicateur de Chargement

Feedback
Présentationnel

Introduction

Le composant Spinner est un indicateur circulaire animé représentant les états d'attente actifs. Excellent pour les transitions rapides, les soumissions de formulaires et les overlays de chargement, il se personnalise avec des échelles explicites et des descriptions accessibles.


Usage

Vous pouvez positionner et configurer les spinners comme suit :

1. Chargeur en ligne standard

Un chargeur par défaut, idéal pour indiquer la progression système dans des sections, conteneurs centrés ou panneaux latéraux.

{
  "type": "spinner",
  "size": "md",
  "label": "Loading..."
}
Loading...

2. Chargeur large accentué

Présente un suivi visuel à grande échelle, souvent utilisé comme pièce maîtresse lors de rechargements complets ou de synchronisations initiales de l'espace de travail.

{
  "type": "spinner",
  "size": "lg",
  "label": "Synchronizing data..."
}
Synchronizing data...

3. Sous-indicateur minuscule (chargeur bouton/contextuel)

Un petit chargeur utilisé dans des tableaux de bord denses ou des cartes contextuelles compactes pour impliquer le rechargement individuel d'assets.

{
  "type": "spinner",
  "size": "sm",
  "label": "Connecting..."
}
Connecting...

Props

PropriétéType de champ CMSDéfautDescription / options prises en charge
Échelle de taille (size)select"md"Contrôle le diamètre et l'épaisseur du cercle.
• Options : "xs", "sm", "md", "lg", "xl", "2xl".
Libellé accessible (label)string-Description alternative annoncée par les lecteurs d'écran. Recommandé pour la conformité.

Architecture Notes

  • Accessible d'emblée : Chaque spinner compile avec un wrapper natif role="status" contenant des libellés réservés aux lecteurs d'écran (class="sr-only"), assurant l'annonce correcte de la progression.
  • Rendu SVG pur : Les animations utilisent des chemins vectoriels légers (<svg>) pivotés via keyframes CSS, sans dépendances lourdes ni images statiques.
  • Taille de mise en page optimale : Les échelles correspondent exactement aux tokens d'espacement du système de design, garantissant l'alignement dans boutons, alertes ou cartes.