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
- 1993Mosaic anime son logo pendant le chargement des pages.
- 1990sNetscape et IE ont leur throbber en haut à droite.
- 2000sAvec Ajax, les GIF animés de spinners se répandent sur le web.
- 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-widthou grille) pour que le bouton ne change pas de taille. Attention :display: inline-blockécrase l'attributhidden.
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égionrole="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é
disabledsur le bouton qui a le focus fait perdre ce focus. Préfèrearia-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é.