Skip to content

Portal

React의 createPortal을 편리하게 사용할 수 있는 컴포넌트입니다.

Props

이름타입설명기본값
childrenReactNodePortal로 렌더링할 컨텐츠-
containerElement | DocumentFragment | nullPortal이 렌더링될 DOM 컨테이너document.body

사용 예시

기본 사용법

tsx
import { Portal } from '@teamsparta/react';

function BasicExample() {
  return (
    <Portal>
      <div>document.body에 렌더링됩니다</div>
    </Portal>
  );
}

특정 컨테이너 지정

tsx
function CustomContainerExample() {
  return (
    <Portal container={document.getElementById('modal-root')}>
      <div>지정된 컨테이너에 렌더링됩니다</div>
    </Portal>
  );
}

주의사항

  • SSR 환경(ex. Next.js)에서 안전하게 동작하도록 설계되었습니다.