Feedback
Barre de progression
Progress bar
Démo
Chargement de la démo…
Une barre qui se remplit au fil d'une tâche : upload, export, installation. Déterminée, elle montre où on en est ; indéterminée, elle dit juste que ça avance. Elle aide à décider si on attend ou si on revient plus tard.
Histoire
Le saviez-vous
Une barre qui accélère vers la fin paraît plus courte qu'une barre qui ralentit, à durée égale. C'est ce qu'a montré Chris Harrison en 2007. Une barre qui cale à 99 % est donc la pire des fins.
Historique
- 1985Brad Myers publie à CHI une étude sur l'intérêt des indicateurs de pourcentage accompli.
- 1993Jakob Nielsen fixe les seuils de 0,1 s, 1 s et 10 s dans Usability Engineering.
- 2007Chris Harrison et son équipe étudient la perception des barres (UIST 2007).
- 2010s
<progress>et<meter>arrivent avec HTML5 ; les barres fines en haut de page (YouTube, NProgress) se répandent.
Vocabulaire
Noms
- FR
- Barre de progression, progression, jauge, barre de chargement
- EN
- Progress bar, loading bar, progress indicator, determinate progress, indeterminate progress, top loading bar
Usages courants
- Upload de fichiers
- Export, installation, mise à jour
- Barre fine en haut de page pendant la navigation
- Traitement long découpé en étapes
Souvent associé à
Les composants qu'on retrouve avec lui, par type de page, dans l'ordre de lecture.
Fiche produit
Voir la maquetteCode
<input type="file" id="file">
<progress id="bar" max="100" value="0" aria-label="Upload progress" hidden></progress>
<p id="status" role="status"></p>
<script>
const bar = document.querySelector('#bar')
const status = document.querySelector('#status')
document.querySelector('#file').addEventListener('change', (e) => {
const file = e.target.files[0]
if (!file) return
const xhr = new XMLHttpRequest()
bar.hidden = false
bar.value = 0
status.textContent = 'Uploading…'
// fetch() has no upload progress event: XHR does
xhr.upload.onprogress = (ev) => {
if (ev.lengthComputable) bar.value = Math.round((ev.loaded / ev.total) * 100)
}
xhr.onload = () => { status.textContent = xhr.status < 300 ? 'Upload complete' : 'Upload failed' }
xhr.onerror = () => { status.textContent = 'Upload failed' }
xhr.open('POST', '/api/upload')
xhr.send(file)
})
</script>À savoir
<progress>sans attributvalueest indéterminé. Avecvalueetmax, il devient déterminé. Pour revenir à l'indéterminé, retire l'attribut :value="0"affiche une barre vide.<meter>n'est pas une barre de progression. Il mesure une valeur dans une plage connue (espace disque, force d'un mot de passe) et gère les seuils aveclow,highetoptimum.fetch()ne fournit pas d'événement de progression pour l'envoi. Pour un upload, utiliseXMLHttpRequestetxhr.upload.onprogress, en vérifiantlengthComputable.- Repères de Jakob Nielsen : moins d'1 s rien, 1 à 10 s un spinner, au-delà de 10 s une barre avec pourcentage. Les barres fines en haut de page (NProgress, YouTube) sont simulées : elles avancent seules jusqu'à 90 % environ, puis sautent à 100 % à la fin.
Accessibilité
Prioritaire
- Donne un nom à la barre :
<label for>ouaria-labelsur<progress>. En version maison,role="progressbar"avecaria-valuenow,aria-valuemin,aria-valuemaxet un nom. Sansaria-valuenow, elle est indéterminée. - Annonce le début, la fin et l'échec dans une région
role="status"séparée, présente dès le chargement de la page. La barre elle-même ne doit pas être une région live.
Souvent oublié
- N'annonce pas chaque pourcent. Le lecteur d'écran lit la valeur quand on arrive sur la barre ; si tu veux plus, annonce par paliers (25 %, 50 %, 75 %).
- La partie remplie doit contraster à 3:1 avec le fond de la piste (WCAG 1.4.11, contraste des éléments non textuels).
- Ne mets pas un
<meter>à la place : il expose un rôlemeter, pas une progression.
Bonus
aria-valuetextpour une valeur parlante : « 3 fichiers sur 10 », « 2 minutes restantes ».- Avec
prefers-reduced-motion, fige l'animation de la barre indéterminée et garde le texte « En cours… ».