본문 바로가기
seungchan.dev
뒤로

스켈레톤 로딩 UI를 어디에, 언제 보여 줄지 정한 기준

스켈레톤 UI를 전체 화면과 일부 영역으로 나눠 적용한 기준, Suspense와 MUI Skeleton으로 만든 부분 로딩, 짧은 로딩에는 스켈레톤을 숨기는 지연 컴포넌트와 이미지용 공통 컴포넌트를 정리했습니다.

4분 읽기#실무 회고#React

스켈레톤 UI는 스피너보다 친절하지만 공짜가 아닙니다. 화면마다 모양을 따로 만들어야 하고, 스피너보다 DOM도 많이 만듭니다.

그래서 스켈레톤을 도입하면서 "어디에 보여 줄지"와 "언제 보여 줄지"를 먼저 정했습니다. 화면 전체와 일부 영역을 나누는 기준을 세우고, 짧은 로딩에는 스켈레톤을 띄우지 않으며, 이미지는 공통 컴포넌트로 처리했습니다.

로딩 중에도 화면 구조를 보여 줘야 했다

네트워크 응답이 길거나 데이터 요청이 많은 화면에서, 사용자가 로딩 중에도 페이지 구조를 파악할 수 있어야 했습니다.

화면마다 드는 구현 비용과 늘어나는 DOM

  • 구현 복잡성: 화면 구조가 복잡할수록 화면에 맞는 스켈레톤을 따로 만드는 작업이 늘었습니다. 여러 뷰포트와 화면 비율을 지원해야 할 때는 시간과 노력이 더 들었습니다.
  • 성능 영향: 스켈레톤은 스피너보다 DOM 요소를 더 많이 만들 수 있어 성능에 영향을 줄 수 있음을 확인했습니다. 그래서 경량화된 컴포넌트를 쓰거나 성능 최적화를 함께 고려해야 했습니다.

이 비용 때문에 모든 화면에 같은 스켈레톤을 깔 수는 없었습니다.

스피너냐 스켈레톤이냐, 전체냐 부분이냐, 바로냐 늦게냐

스피너 vs 스켈레톤

선택지얻는 것잃는 것
로딩 스피너만들기 쉽고 DOM이 적음로딩 중 콘텐츠 크기·배치를 알 수 없음
스켈레톤콘텐츠 크기·배치를 미리 보여 줌, 특정 부분만 로딩 중이라고 표시 가능화면마다 구현 비용, DOM 증가

스켈레톤은 콘텐츠의 크기와 배치를 미리 보여 주기 때문에, 네트워크 지연이나 데이터 처리로 로딩이 길어져도 사용자 불편이 줄어듭니다. 데이터가 단계적으로 로드될 때 특정 부분만 로딩 중이라고 표시하기에도 좋습니다. 그래서 스켈레톤을 골랐고, 비용은 적용 범위와 표시 시점으로 줄이기로 했습니다.

전체 스켈레톤 vs 부분 스켈레톤

화면 전체에 스켈레톤을 보여 줄 페이지

  1. 대량의 데이터를 패칭하고, 화면 전환 후 로딩이 상대적으로 길어질 수 있는 페이지
  2. 페이지 대부분이 비어 있거나 초기 상태에 콘텐츠가 없을 가능성이 큰 페이지

예: 대시보드, 게시판 목록, 검색 결과 페이지. 데이터가 로드될 때까지 사용자 경험을 유지하려면 전체 스켈레톤이 필요합니다.

일부 영역에만 스켈레톤을 보여 줄 페이지

  1. 상대적으로 적은 데이터를 패칭하고, 화면 일부만 비어 있을 수 있는 페이지
  2. 데이터 패칭 범위가 제한적이고, 주요 레이아웃은 이미 렌더링된 상태

예: 프로필 페이지, 상품 상세 페이지, 모달 로딩. 스켈레톤이 필요한 구간은 콘텐츠의 특정 영역으로 한정됩니다.

바로 표시 vs 지연 표시

1초 미만의 지연에서는 스켈레톤을 표시하지 않고 데이터를 바로 렌더링하기로 했습니다. "1초 미만의 로딩에서는 스켈레톤보다 데이터를 바로 보여 주는 것이 사용자 경험에 더 유리하다"는 연구 결과를 근거로 정한 기준입니다.

Suspense, MUI Skeleton, 지연 컴포넌트, 이미지 스켈레톤

홈 화면: Suspense로 프로필 카드만 덮는다

프로젝트 홈 화면은 메인 프로필 정보 말고는 추가 데이터 패칭이 없습니다. 그래서 전체 스켈레톤 대신, 프로필 영역에만 부분 스켈레톤을 적용했습니다.

프로필 카드 자리에 들어갈 스켈레톤입니다. 바깥의 DeferredComponent는 아래 지연 표시에서 다룹니다.

jsx
//@skeleton/common/SkeletonProfileCard
...
import { Skeleton } from '@mui/material';
 
const SkeletonProfileCard = () => {
  return (
    <DeferredComponent>
      <div className='px-[12px] pt-[20px] pb-[40px]'>
        <Skeleton
          variant='rounded'
          width='100%'
          height={229}
          animation='wave'
          sx={{ borderRadius: '25px' }}
        />
      </div>
    </DeferredComponent>
  );
};
 
export default SkeletonProfileCard;

React의 Suspense로 데이터를 불러오는 컴포넌트만 이 스켈레톤으로 대체합니다.

jsx
		<section className='flex flex-col'>
            <div className='px-1'>
              <Suspense fallback={<SkeletonProfileCard />}>
                <GuardianPatientCardSpread
                  userId={userId}
                  patientList={patientList}
                />
              </Suspense>
            </div>
          </section>
 

DOM 부담은 Material-UI의 Skeleton 컴포넌트로 줄였습니다. 불필요한 요소 없이 가벼운 로딩 화면을 만들 수 있었습니다.

지연 표시: DeferredComponent

정해진 시간이 지나기 전에는 아무것도 그리지 않고, 그 뒤에야 스켈레톤을 보여 줍니다.

tsx
import { PropsWithChildren, useEffect, useState } from 'react';
 
// ** 지연시간 200ms 미만일 때 스켈레톤 미노출 / 200ms 이상일 때 스켈레톤 노출 **
const DeferredComponent = ({ children }: PropsWithChildren) => {
  const [isDeferred, setIsDeferred] = useState(false);
 
  useEffect(() => {
    const timeOut = setTimeout(() => {
      setIsDeferred(true);
    }, 200);
    return () => clearTimeout(timeOut);
  }, []);
 
  if (!isDeferred) return null;
  return <>{children}</>;
};
 
export default DeferredComponent;

이미지: 로드가 끝날 때까지 스켈레톤

이미지 로딩은 사용자가 느끼는 시각적 완성도에 큰 영향을 줍니다. Next.js Image 컴포넌트의 onLoadingComplete·onLoad 이벤트를 활용해, 로드 전에는 스켈레톤을 표시하고 로드가 끝나면 숨깁니다.

tsx
 
import React, { ReactElement, useState } from 'react';
import Image from 'next/image';
import { Skeleton } from '@mui/material';
 
interface SkeletonImageProps {
  src: string | undefined | null;
  alt: string;
  imgStyle: string;
  [key: string]: any;
}
 
const SkeletonImage = ({
  src,
  alt,
  imgStyle,
  onLoad,
  ...props
}: SkeletonImageProps) => {
  const [isLoading, setIsLoading] = useState(true);
 
  if (!src) {
    return <Skeleton variant='rectangular' className={`${imgStyle}`} />;
  }
 
  return (
    <>
      {isLoading && (
        <>{isLoading && <Skeleton variant='rectangular' className={`${imgStyle}`} />}</>
      )}
 
      <Image
        src={src}
        alt={alt}
        fill
        priority={true}
        onLoad={(e) => {
          if (onLoad) onLoad(e);
          setIsLoading(false);
        }}
        {...props}
      />
    </>
  );
};
 
export default SkeletonImage;

레이아웃은 바로, 스켈레톤은 필요한 곳에만

홈 화면에서는 주요 레이아웃이 즉시 렌더링되고, 데이터가 필요한 프로필 영역에만 스켈레톤이 보입니다. MUI Skeleton으로 렌더링 성능 부담을 줄이면서도 자연스러운 로딩 경험을 줄 수 있었습니다.

이미지 스켈레톤을 공통 컴포넌트로 관리하자 모든 이미지의 로딩 상태를 같은 방식으로 처리할 수 있었고, 개발 시간과 유지보수 비용도 줄었습니다. 팀원들의 코드도 일관되게 유지됐습니다.

남은 한계

화면 구조가 복잡하거나 여러 뷰포트를 지원해야 하는 화면은 여전히 스켈레톤을 따로 만들어야 합니다.