Infinite scroll en React avec IntersectionObserver
Guide de l'infinite scroll en React
Infinite scroll en React : hook IntersectionObserver | We.Inc
Créez un infinite scroll en React avec un petit hook IntersectionObserver, sans aucun package, puis gardez les longs flux rapides grâce à la virtualisation. Démos en direct et code à copier.
Placez un élément sentinelle vide après le dernier élément et surveillez-le avec IntersectionObserver. Quand il arrive à quelques centaines de pixels du viewport, récupérez la page suivante et ajoutez-la. Un hook d'une vingtaine de lignes fait cela sans bibliothèque. Quand la liste atteint des milliers de lignes, ajoutez la virtualisation pour que seules les lignes visibles existent dans le DOM.
Les options d'IntersectionObserver qui comptent pour l'infinite scroll
- Option
- Par défaut
- Usage pour l'infinite scroll
- Le viewport
- Définissez-la sur la boîte défilante si la liste défile dans un panneau
- rootMargin
- 0px 0px 0px 0px
- Quelque chose comme 0px 0px 400px 0px pour commencer à charger plus tôt
- Laissez à 0 : il suffit qu'une partie de la sentinelle soit visible
Les deux démos ci-dessous tournent sur cette page. La première charge de fausses pages de résultats pendant que vous faites défiler son panneau ; la seconde fait défiler dix mille lignes tout en n'affichant que la vingtaine que vous voyez. Le code de chacune se trouve en dessous, prêt à copier.
- Faites défiler le panneau du flux. Quand la sentinelle approche du bas, la page d'éléments suivante est ajoutée.
- Surveillez le compteur : le chargement s'arrête à la dernière page et un message remplace la sentinelle.
- Faites défiler la liste virtuelle et comparez le nombre de lignes affichées au total.
- Copiez le hook useInfiniteScroll et remplacez le faux chargeur par votre appel d'API.
- Évitez les doubles chargements : sautez la requête quand une autre est en cours, et arrêtez l'observation quand il n'y a plus de pages.
- Gardez un bouton Charger plus visible comme solution de repli. Il aide les utilisateurs du clavier et tous ceux dont l'observer ne se déclenche jamais.
- Ne placez pas de liens importants dans un pied de page sous un flux sans fin : personne ne pourra jamais l'atteindre.
- Enregistrez le curseur ou l'offset de page dans l'URL si les gens doivent partager une position ou y revenir.
- Donnez à chaque élément une key stable issue de vos données pour que les pages ajoutées ne provoquent pas un nouveau rendu des anciennes.
Questions fréquentes
Faut-il une bibliothèque pour l'infinite scroll en React ?
Non. IntersectionObserver est disponible dans tous les grands navigateurs depuis 2019, et un petit hook couvre le cas courant. Une bibliothèque de récupération de données avec des aides à la pagination intégrées vaut le coup si vous en utilisez déjà une pour la mise en cache des requêtes.
Qu'est-ce que la virtualisation et quand en ai-je besoin ?
La virtualisation n'affiche que les lignes de la fenêtre visible plus une petite marge, positionnées dans un espaceur qui fait toute la hauteur de la liste. Utilisez-la quand le DOM contient des milliers de lignes et que le défilement ou la saisie commencent à ramer. @tanstack/react-virtual et son hook useVirtualizer sont un choix courant.
L'infinite scroll est-il mauvais pour le SEO ?
Les robots d'exploration ne font pas défiler les pages comme les humains, un contenu qui n'apparaît qu'après défilement risque donc de ne jamais être vu. Adossez le flux à de vraies URL paginées comme ?page=2 qui se chargent seules, et créez des liens vers elles.
Pourquoi mon observer se déclenche-t-il en boucle ?
En général, l'effet recrée l'observer à chaque rendu parce que le callback change d'identité, ou la première page est trop courte pour pousser la sentinelle hors de l'écran. Gardez le dernier callback dans une ref et assurez-vous que chaque page dépasse la hauteur du viewport.
Pourquoi une sentinelle vaut mieux que les événements scroll
- L'ancienne approche écoutait scroll et comparait scrollTop à scrollHeight à chaque événement. Cela s'exécute des dizaines de fois par seconde sur le thread principal et demande un throttling pour rester fluide.
- Un observer laisse le navigateur faire les calculs géométriques et ne vous appelle que lorsque la sentinelle franchit la marge définie. Il ne coûte rien pendant que la personne lit, et le même code fonctionne pour le défilement de window comme pour un panneau défilant.
Chargement, erreurs et fin de liste
- Suivez trois choses en plus des éléments : si une page est en cours de chargement, si la dernière requête a échoué et s'il reste des pages. Affichez un petit indicateur pendant le chargement, un bouton Réessayer en cas d'échec et un message de fin clair quand le serveur indique qu'il n'y a plus rien.
- Les API à curseur, qui renvoient un jeton pour la page suivante, sont plus sûres que les offsets quand de nouveaux éléments arrivent en haut d'un flux, car les offsets se décalent et créent des doublons.
Le hook useInfiniteScroll
useInfiniteScroll.ts
Renvoie une ref pour la sentinelle. Le dernier onLoadMore est conservé dans une ref, l'observer n'est donc créé qu'à chaque changement de enabled, pas à chaque rendu.
Feed.tsx utilisant le hook
Le drapeau loading empêche les doubles requêtes, et hasMore désactive l'observer à la fin.
Virtualiser une longue liste avec TanStack Virtual
Installez-le avec npm install @tanstack/react-virtual. La boîte extérieure défile, la boîte intérieure fait la hauteur de toute la liste, et chaque ligne visible est mise en place avec translateY.
VirtualList.jsx
Seules les lignes proches de la fenêtre visible sont affichées. estimateSize est la hauteur d'une ligne en pixels.
Démo : un flux qui se charge pendant le défilement
Faites défiler le panneau. Une nouvelle page de dix éléments arrive chaque fois que la sentinelle entre dans la zone, jusqu'à huit pages.
Démo de flux
Publication {n}
Chargement...
Vous êtes arrivé à la fin.
Charger plus
{items} éléments, page {page} sur {last}
Réinitialiser
Démo : 10 000 lignes, seules les visibles sont affichées
Faites défiler la liste et regardez combien peu de lignes existent réellement dans la page à chaque instant.
Démo de liste virtuelle
Ligne {n}
{shown} lignes affichées sur {total}
Commencer gratuitement · Sans carte bancaire
Voir aussi: Guides
- 60 questions d'entretien React avec réponses
- Lazy loading React
- Sections repliables et accordéons en React Native
- Liste déroulante React Native
- Formulaires React Native
- Mot de passe React Native
- Boutons radio React Native, construits avec Pressable
- Props de TextInput React Native, avec recherche
Produit
Pour qui
- Pour les agences
- Pour les indépendants
- Pour les hébergeurs
- Pour les plateformes SaaS
- Pour les startups
- Services financiers
- Solutions pour la santé
Fonctionnalités
- Éditeur visuel
- SEO et analyses
- Image de marque personnalisée
- Tableau de bord client
- Facturation revendeur
Ressources
- Blog
- Centre d'aide
- Outils gratuits pour les entreprises
- Free UI Components
- Modèles
- Collections de modèles
- Exemples de sites
- Guides
- Comparatifs
- Alternatives
- Les meilleurs
- Avis
- Guides des tarifs
- Cas d'usage
- Glossaire et guides
- Intégrations
- Développeurs
- Benchmark
- Windows App