React Academy · 강의

useInfiniteQuery를 활용한 무한 스크롤과 페이지 매김

페이지로 나뉜 데이터를 가져오고 useInfiniteQuery로 페이지를 매끄럽게 추가 로드합니다.

레슨 4/413개 단계

useInfiniteQuery를 활용한 무한 스크롤과 페이지 매김은(는) CoddyKit의 무료 React Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 React Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. React Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

환영합니다

이 lesson에서는 useInfiniteQuery를 사용해 페이지로 나뉜 데이터를 가져오고, 사용자가 스크롤할 때 더 많은 페이지를 로드하는 무한 스크롤 패턴을 구현합니다.

useInfiniteQuery란 무엇인가요

useInfiniteQuery는 데이터를 ‘페이지’ 단위로 가져옵니다. 각 페이지는 별도로 가져온 후 캐시된 목록에 추가됩니다. fetchNextPage, hasNextPage, isFetchingNextPage 유틸리티를 제공합니다.

기본 설정

initialPageParam과 getNextPageParam을 정의합니다. queryFn은 현재 pageParam을 받아 결과 페이지를 반환해야 합니다.
const { data, fetchNextPage, hasNextPage } = useInfiniteQuery({
  queryKey: ['posts'],
  queryFn: ({ pageParam }) =>
    fetch('/api/posts?cursor=' + pageParam).then(r => r.json()),
  initialPageParam: 0,
  getNextPageParam: (lastPage) => lastPage.nextCursor ?? undefined,
});

getNextPageParam

getNextPageParam은 마지막으로 가져온 페이지와 모든 페이지를 받습니다. 다음 페이지의 커서 또는 번호를 반환하고, 더 이상 페이지가 없음을 나타내려면 undefined 또는 null을 반환합니다(hasNextPage가 false로 설정됩니다).
getNextPageParam: (lastPage, allPages) => {
  return lastPage.hasMore ? lastPage.nextCursor : undefined;
}

모든 페이지 렌더링

data.pages는 페이지 결과의 배열입니다. 모든 항목을 연속된 목록으로 렌더링하려면 페이지를 평탄화합니다.
const allPosts = data.pages.flatMap(page => page.items);

return (
  <ul>
    {allPosts.map(post => <li key={post.id}>{post.title}</li>)}
  </ul>
);

추가 로드 버튼

'Load More' 버튼을 추가하고 이 버튼에서 fetchNextPage를 호출합니다. 더 이상 페이지가 없거나 가져오기가 진행 중일 때는 버튼을 비활성화합니다.
<button
  onClick={() => fetchNextPage()}
  disabled={!hasNextPage || isFetchingNextPage}
>
  {isFetchingNextPage ? 'Loading...' : hasNextPage ? 'Load More' : 'No more posts'}
</button>

IntersectionObserver를 사용한 무한 스크롤

목록 하단의 감지용 div에 IntersectionObserver를 연결합니다. 이 요소가 뷰포트에 들어오면 fetchNextPage를 자동으로 호출합니다.
const observerRef = useRef();
useEffect(() => {
  const observer = new IntersectionObserver(entries => {
    if (entries[0].isIntersecting && hasNextPage) fetchNextPage();
  });
  if (observerRef.current) observer.observe(observerRef.current);
  return () => observer.disconnect();
}, [hasNextPage, fetchNextPage]);

<div ref={observerRef} />  {/* sentinel at bottom */}

양방향 무한 스크롤

채팅 앱에서는 양방향 스크롤을 지원합니다. 이전 메시지에는 fetchNextPage를 사용하고, 최신 메시지에는 getPreviousPageParam과 fetchPreviousPage를 사용합니다.

페이지 기반과 커서 기반 페이지 매김

오프셋/페이지 기반: initialPageParam=1로 설정하고 getNextPageParam은 lastPage.page + 1을 반환합니다. 커서 기반: 마지막 항목의 ID를 커서로 사용합니다. 커서 기반 방식이 실시간 데이터에 더 안정적입니다.
// Offset-based
getNextPageParam: (lastPage) => lastPage.page + 1

무한 쿼리 다시 가져오기

무한 쿼리에서 invalidateQueries를 호출하면 첫 번째 페이지만 다시 가져옵니다. 모든 페이지를 다시 가져오려면(예: 새 게시물이 추가된 후) queryClient.resetQueries 또는 refetchType: 'all'을 사용합니다.

빠른 확인

더 이상 로드할 페이지가 없음을 나타내려면 getNextPageParam은 무엇을 반환해야 합니까?

복습

useInfiniteQuery는 data.pages에 페이지를 누적합니다. 렌더링하려면 flatMap으로 평탄화합니다. 중지하려면 getNextPageParam이 undefined를 반환하도록 합니다. 버튼 클릭이나 무한 스크롤의 IntersectionObserver에서 fetchNextPage를 실행합니다.

과정 완료

축하합니다! **React Query: 서버 상태 관리**를 완료하셨습니다. 이제 TanStack Query로 데이터를 가져오고, 캐시하고, 변경하고, 페이지를 나누고, 무한히 스크롤할 수 있습니다.
무료로 시작

AI 튜터와 함께 React을(를) 배우세요 — 무료

브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.

코스
88
레슨
324

자주 묻는 질문

“useInfiniteQuery를 활용한 무한 스크롤과 페이지 매김” 강의는 무료인가요?

네 — “useInfiniteQuery를 활용한 무한 스크롤과 페이지 매김” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 React Academy 강의 전체를 잠금 해제할 수 있습니다. React Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“useInfiniteQuery를 활용한 무한 스크롤과 페이지 매김”에서 뭘 배우나요?

페이지로 나뉜 데이터를 가져오고 useInfiniteQuery로 페이지를 매끄럽게 추가 로드합니다. 브라우저에서 직접 실행하는 실습 코드로 React Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

React Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 React Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.

“useInfiniteQuery를 활용한 무한 스크롤과 페이지 매김” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 React Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 React Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. React Query와 QueryClient 설정하기
  2. 캐싱, 오래된 시간과 백그라운드 재가져오기
  3. useMutation으로 변형 처리하기
  4. useInfiniteQuery를 활용한 무한 스크롤과 페이지 매김
← React Academy(으)로 돌아가기