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
- 2009Loren Brichter l'introduit dans Tweetie 2.
- 2010Twitter rachète Tweetie, qui devient l'app officielle.
- 2013Twitter obtient un brevet sur le pull-to-refresh.
- 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.
Fil d'actualité
Voir la maquetteCode
<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: containle désactive si tu en fais un toi-même. - Amortis le déplacement (×0,5) pour donner la sensation d'élastique, et anime
translateplutôt quetopoumargin. - 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 proposetouch-action: pan-x pan-downen 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-labelsur 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.