FRENEnglish version

Listes

Tirer pour rafraîchir

Pull to refresh

Démo

Chargement de la démo…

Un geste tactile : on tire la liste vers le bas depuis le haut, on relâche, et le contenu se recharge. Il sert sur les listes qui changent souvent, surtout sur mobile.

Histoire

Le saviez-vous

Loren Brichter l'a inventé pour Tweetie, un client Twitter, vers 2008-2009. Twitter a racheté l'app et obtenu un brevet sur le geste en 2013, tout en promettant de ne l'utiliser qu'en défense. Brichter lui-même a dit plus tard qu'il trouvait le geste un peu dépassé.

Historique

  1. 2009Loren Brichter l'introduit dans Tweetie 2.
  2. 2010Twitter rachète Tweetie, qui devient l'app officielle.
  3. 2013Twitter obtient un brevet sur le pull-to-refresh.
  4. 2010sAndroid (SwipeRefreshLayout) et iOS (UIRefreshControl) l'intègrent nativement.

Vocabulaire

Noms

FR
Tirer pour rafraîchir, glisser pour actualiser, tirer pour actualiser
EN
Pull to refresh, pull-down to refresh, swipe to refresh, PTR

Usages courants

  • Fils et boîtes de réception sur mobile
  • Listes dont le contenu change souvent
  • Apps sans bouton « Actualiser » visible

Souvent associé à

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

Code

<button id="refresh">Refresh</button>
<p id="status" role="status"></p>
<ul id="list" style="overflow-y: auto; overscroll-behavior-y: contain">…</ul>

<script>
  const list = document.querySelector('#list')
  const status = document.querySelector('#status')
  let startY = null
  let offset = 0

  // At the top, leave downward pulls to JS; elsewhere, scroll normally
  const sync = () => (list.style.touchAction = list.scrollTop === 0 ? 'pan-x pan-down' : 'pan-x pan-y')
  list.addEventListener('scroll', sync, { passive: true })
  sync()

  list.addEventListener('pointerdown', (e) => { if (list.scrollTop === 0) startY = e.clientY })
  list.addEventListener('pointermove', (e) => {
    if (startY === null) return
    offset = Math.max(0, (e.clientY - startY) * 0.5) // elastic damping
    list.style.translate = `0 ${offset}px`
  })
  const release = (e) => {
    const pulled = startY !== null && e.type === 'pointerup' && offset > 60
    startY = null
    offset = 0
    list.style.translate = ''
    if (pulled) refresh()
  }
  list.addEventListener('pointerup', release)
  list.addEventListener('pointercancel', release)
  document.querySelector('#refresh').addEventListener('click', refresh)

  async function refresh() {
    status.textContent = 'Refreshing…'
    const items = await fetch('/api/latest').then((r) => r.json())
    list.prepend(...items.map((t) => Object.assign(document.createElement('li'), { textContent: t })))
    status.textContent = `${items.length} new items`
  }
</script>

À savoir

  • Chrome Android et Safari iOS font déjà un pull-to-refresh sur la page : overscroll-behavior-y: contain le désactive si tu en fais un toi-même.
  • Amortis le déplacement (×0,5) pour donner la sensation d'élastique, et anime translate plutôt que top ou margin.
  • Ne démarre le geste que si la liste est tout en haut (scrollTop === 0). Sinon il entre en conflit avec le défilement normal.
  • Au tactile, le navigateur garde le geste pour lui et envoie pointercancel. La spec Pointer Events propose touch-action: pan-x pan-down en haut de liste. Le support des valeurs directionnelles varie : teste sur iOS.

Accessibilité

Prioritaire

  • Toujours une autre façon d'actualiser : un bouton visible. Le geste n'est pas découvrable, et un glisser doit avoir une alternative sans glisser (WCAG 2.5.7).
  • Annonce l'état dans un role="status" : « Actualisation… », puis « 3 nouveaux messages ».

Souvent oublié

  • Un spinner seul ne dit rien. Un aria-label sur un <span> sans rôle n'est pas lu de façon fiable : passe par la région de statut.
  • Ne vole pas le focus. Les nouveaux éléments arrivent en haut : laisse le focus où il est et annonce combien sont arrivés.

Bonus

  • Avec prefers-reduced-motion, supprime l'effet élastique et garde juste l'indicateur.
  • Affiche l'heure de la dernière mise à jour près du bouton.

Qui l'utilise