Scroll infinito en React con IntersectionObserver

Guía de scroll infinito en React

Scroll infinito en React: hook con IntersectionObserver | We.Inc

Crea scroll infinito en React con un pequeño hook de IntersectionObserver, sin necesidad de paquetes, y mantén rápidos los feeds largos con virtualización. Demos en vivo y código para copiar.

Coloca un elemento centinela vacío después del último elemento y obsérvalo con IntersectionObserver. Cuando llegue a unos cientos de píxeles del viewport, pide la siguiente página y añádela. Un hook de veinte líneas lo hace sin librerías. Cuando la lista llegue a miles de filas, añade virtualización para que solo existan en el DOM las filas visibles.

Opciones de IntersectionObserver que importan para el scroll infinito

  • Opción
  • Valor por defecto
  • Uso para scroll infinito
  • El viewport
  • Asígnala a la caja con scroll si la lista se desplaza dentro de un panel
  • rootMargin
  • 0px 0px 0px 0px
  • Algo como 0px 0px 400px 0px para empezar a cargar antes
  • Déjala en 0: basta con que se vea cualquier parte del centinela

Las dos demos de abajo se ejecutan en esta página. La primera carga páginas de resultados falsos mientras desplazas su panel; la segunda recorre diez mil filas dibujando solo las veinte o así que puedes ver. Debajo está el código de cada una, listo para copiar.

  • Desplaza el panel del feed. Cuando el centinela se acerca al final, se añade la siguiente página de elementos.
  • Fíjate en el contador: la carga se detiene en la última página y un mensaje sustituye al centinela.
  • Desplaza la lista virtual y compara el número de filas renderizadas con el total.
  • Copia el hook useInfiniteScroll y cambia el cargador falso por la llamada a tu API.
  • Protégete de las cargas dobles: omite la petición mientras haya otra en curso y deja de observar cuando no queden más páginas.
  • Mantén un botón Cargar más visible como alternativa. Ayuda a los usuarios de teclado y a cualquiera cuyo observer nunca se active.
  • No pongas enlaces importantes en un pie de página bajo un feed sin fin; nadie podrá llegar a ellos.
  • Guarda el cursor o el offset de la página en la URL si la gente necesita compartir una posición o volver a ella.
  • Dale a cada elemento una key estable a partir de tus datos para que las páginas añadidas no vuelvan a renderizar las anteriores.

Preguntas frecuentes

¿Necesito una librería para el scroll infinito en React?

No. IntersectionObserver está disponible en todos los navegadores principales desde 2019, y un hook pequeño cubre el caso habitual. Una librería de obtención de datos con utilidades de paginación integradas vale la pena cuando ya usas una para cachear peticiones.

¿Qué es la virtualización y cuándo la necesito?

La virtualización renderiza solo las filas dentro de la ventana visible más un pequeño margen, colocadas dentro de un espaciador con la altura total de la lista. Recurre a ella cuando el DOM tenga miles de filas y el desplazamiento o la escritura empiecen a ir lentos. @tanstack/react-virtual y su hook useVirtualizer son una opción habitual.

¿El scroll infinito es malo para el SEO?

Los rastreadores de los buscadores no se desplazan como las personas, así que el contenido que solo aparece al desplazarse puede no verse nunca. Respalda el feed con URLs paginadas reales como ?page=2 que carguen por sí solas, y enlázalas.

¿Por qué mi observer se dispara una y otra vez?

Normalmente el efecto vuelve a crear el observer en cada render porque el callback cambia de identidad, o la primera página es demasiado corta para sacar el centinela de la pantalla. Guarda el callback más reciente en una ref y asegúrate de que cada página ocupe más que el viewport.

Por qué un centinela es mejor que los eventos scroll

  • El enfoque antiguo escuchaba scroll y comparaba scrollTop con scrollHeight en cada evento. Eso se ejecuta decenas de veces por segundo en el hilo principal y necesita throttling para mantenerse fluido.
  • Un observer deja que el navegador haga los cálculos geométricos y solo te avisa cuando el centinela cruza el margen que has definido. No cuesta nada mientras la persona lee, y el mismo código funciona para el scroll de la ventana o de un panel.

Carga, errores y el final de la lista

  • Controla tres cosas además de los elementos: si se está cargando una página, si falló la última petición y si existen más páginas. Muestra un pequeño indicador de carga mientras carga, un botón de reintentar si falla y un mensaje claro de final cuando el servidor indique que no queda nada.
  • Las APIs basadas en cursor, que devuelven un token para la siguiente página, son más seguras que los offsets cuando llegan elementos nuevos al principio de un feed, porque los offsets se desplazan y provocan duplicados.

El hook useInfiniteScroll

useInfiniteScroll.ts

Devuelve una ref para el centinela. El onLoadMore más reciente se guarda en una ref para que el observer se cree una vez por cada cambio de enabled, no en cada render.

Feed.tsx usando el hook

La marca de carga evita las peticiones dobles, y hasMore desactiva el observer al final.

Virtualizar una lista larga con TanStack Virtual

Instálalo con npm install @tanstack/react-virtual. La caja exterior se desplaza, la interior es tan alta como toda la lista y cada fila visible se coloca en su sitio con translateY.

VirtualList.jsx

Solo se renderizan las filas cercanas a la ventana visible. estimateSize es la altura de la fila en píxeles.

Demo: un feed que carga mientras te desplazas

Desplázate dentro del panel. Llega una página nueva de diez elementos cada vez que el centinela entra en el rango, hasta ocho páginas.

Demo del feed

Publicación {n}

Cargando...

Has llegado al final.

Cargar más

{items} elementos, página {page} de {last}

Reiniciar

Demo: 10,000 filas, solo se renderizan las visibles

Desplaza la lista y observa qué pocas filas existen realmente en la página en cada momento.

Demo de lista virtual

Fila {n}

Renderizando {shown} de {total} filas

Empieza gratis · Sin tarjeta de crédito

Relacionado: Guías

Producto

Para quién es

Funciones

Recursos

Empresa

Mapa del sitio