FRENEnglish version

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

  1. 1985Brad Myers publie à CHI une étude sur l'intérêt des indicateurs de pourcentage accompli.
  2. 1993Jakob Nielsen fixe les seuils de 0,1 s, 1 s et 10 s dans Usability Engineering.
  3. 2007Chris Harrison et son équipe étudient la perception des barres (UIST 2007).
  4. 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.

Code

<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 attribut value est indéterminé. Avec value et max, 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 avec low, high et optimum.
  • fetch() ne fournit pas d'événement de progression pour l'envoi. Pour un upload, utilise XMLHttpRequest et xhr.upload.onprogress, en vérifiant lengthComputable.
  • 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> ou aria-label sur <progress>. En version maison, role="progressbar" avec aria-valuenow, aria-valuemin, aria-valuemax et un nom. Sans aria-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ôle meter, pas une progression.

Bonus

  • aria-valuetext pour 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… ».

Qui l'utilise