Portal
React의 createPortal을 편리하게 사용할 수 있는 컴포넌트입니다.
Props
| 이름 | 타입 | 설명 | 기본값 |
|---|---|---|---|
| children | ReactNode | Portal로 렌더링할 컨텐츠 | - |
| container | Element | DocumentFragment | null | Portal이 렌더링될 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)에서 안전하게 동작하도록 설계되었습니다.
