FRENEnglish version

Feedback

Spinner

Spinner

Démo

Chargement de la démo…

Une petite animation qui tourne ou pulse pour dire « je travaille ». On l'utilise quand on ne sait pas combien de temps l'attente va durer. Il rassure l'utilisateur et lui évite de cliquer deux fois.

Histoire

Le saviez-vous

Le nom technique officiel du logo animé des navigateurs est « throbber ». Celui de Netscape montrait des étoiles filantes au-dessus d'un N, et celui de Mosaic un globe qui tournait.

Historique

  1. 1993Mosaic anime son logo pendant le chargement des pages.
  2. 1990sNetscape et IE ont leur throbber en haut à droite.
  3. 2000sAvec Ajax, les GIF animés de spinners se répandent sur le web.
  4. 2013+Les squelettes remplacent les spinners pour le chargement de contenu.

Vocabulaire

Noms

FR
Spinner, indicateur de chargement, loader, roue de chargement
EN
Spinner, throbber, activity indicator, loading spinner

Usages courants

  • Bouton en cours d'envoi ou d'export
  • Attente courte de durée inconnue (appel API)
  • Rafraîchissement d'une liste ou d'un panneau
  • Onglet de navigateur qui charge une page

Souvent associé à

Les composants qu'on retrouve avec lui, par type de page, dans l'ordre de lecture.

Code

<button id="export" type="button">
  <span class="spinner" aria-hidden="true" hidden></span>
  Export
</button>
<p id="status" role="status"></p>

<style>
  .spinner { display: inline-block; width: 1em; height: 1em; border: 2px solid currentColor; border-right-color: transparent; border-radius: 50%; animation: spin 0.8s linear infinite; }
  .spinner[hidden] { display: none; }
  @keyframes spin { to { transform: rotate(360deg); } }
  @media (prefers-reduced-motion: reduce) { .spinner { animation-duration: 2.4s; } }
</style>

<script>
  const btn = document.querySelector('#export')
  const spinner = btn.querySelector('.spinner')
  const status = document.querySelector('#status')

  btn.addEventListener('click', async () => {
    if (btn.getAttribute('aria-disabled') === 'true') return
    btn.setAttribute('aria-disabled', 'true')
    spinner.hidden = false
    status.textContent = 'Exporting…'
    const res = await fetch('/api/export', { method: 'POST' }).catch(() => null)
    status.textContent = res?.ok ? 'Export ready' : 'Export failed'
    spinner.hidden = true
    btn.removeAttribute('aria-disabled')
  })
</script>

À savoir

  • Le spinner sert aux attentes courtes et de durée inconnue. Si tu connais l'avancement, ou si ça dure plus de 10 s, passe à une barre de progression : elle a sa propre fiche.
  • Évite le flash : n'affiche le spinner qu'après 300 à 500 ms. Une fois affiché, garde-le un minimum de temps pour qu'il ne clignote pas.
  • En CSS, anime seulement transform: rotate() : l'animation tourne sur le compositeur, même quand le thread principal est occupé.
  • Dans un bouton, garde le libellé et réserve la place du spinner (min-width ou grille) pour que le bouton ne change pas de taille. Attention : display: inline-block écrase l'attribut hidden.

Accessibilité

Prioritaire

  • Un spinner en CSS est invisible pour un lecteur d'écran. Mets-le en aria-hidden="true" et annonce « Export en cours… » puis « Export prêt » dans une région role="status" présente dès le chargement de la page.
  • Dans un bouton, ne remplace pas le texte par le spinner : le libellé reste le nom accessible du bouton. Un bouton qui ne contient plus qu'une icône animée n'a plus de nom.

Souvent oublié

  • disabled sur le bouton qui a le focus fait perdre ce focus. Préfère aria-disabled="true" et bloque le double envoi dans le code.
  • Avec prefers-reduced-motion, ralentis la rotation ou remplace-la par un signe fixe, sans supprimer tout indice d'attente : le texte doit suffire.
  • Annonce aussi l'échec. Un spinner qui disparaît sans message laisse croire que tout s'est bien passé.

Bonus

  • aria-busy="true" sur la zone en cours de mise à jour, retiré à la fin.
  • Si l'attente s'éternise, change le message (« Toujours en cours… ») pour dire que rien n'est bloqué.

Qui l'utilise