https://react-ko.dev/reference/react-dom/createPortal

<div>  
	<SomeComponent />  
	{createPortal(children, domNode, key?)}  
</div>

parameters

  • children : JSX or ๋ฌธ์ž์—ด or ์ˆซ์ž ๋“ฑ ๋ฆฌ์•กํŠธ๋กœ ๋ Œ๋”๋ง ํ•  ์ˆ˜ ์žˆ๋Š” ๋ชจ๋“  ๊ฒƒ
  • domNode : document.getElementById()๊ฐ€ ๋ฐ˜ํ™˜ํ•˜๋Š” ๊ฒƒ๊ณผ ๊ฐ™์€ ์ผ๋ถ€ DOM ๋…ธ๋“œ
  • key (optional) : ํฌํ„ธ์˜ ํ‚ค๋กœ ์‚ฌ์šฉํ•  ๊ณ ์œ  ๋ฌธ์ž์—ด ๋˜๋Š” ์ˆซ์ž

Caveats

  • ํฌํ„ธ์˜ ์ด๋ฒคํŠธ๋Š” DOM ํŠธ๋ฆฌ๊ฐ€ ์•„๋‹Œ React ํŠธ๋ฆฌ์—๋”ฐ๋ผ ์ „ํŒŒ๋œ๋‹ค
  • ํฌํ„ธ์€ DOM ๋…ธ๋“œ์˜ ๋ฌผ๋ฆฌ์  ๋ฐฐ์น˜๋งŒ ๋ณ€๊ฒฝํ•œ๋‹ค. ๋‹ค๋ฅธ ๋ชจ๋“  ๋ฉด์—์„œ๋Š” JSX๋Š” ์ด๋ฅผ ๋ Œ๋”๋งํ•˜๋Š” React ์ปดํฌ๋„ŒํŠธ์˜ ์ž์‹ ๋…ธ๋“œ ์—ญํ• ์„ ํ•œ๋‹ค.

Usage

Rendering React components into non-React server markup

๋ฆฌ์•กํŠธ ๋ฃจํŠธ๊ฐ€ ๋ฆฌ์•กํŠธ๋กœ ๋นŒ๋“œ๋˜์ง€ ์•Š์€ ์ •์ ํŽ˜์ด์ง€ ๋˜๋Š” ์„œ๋ฒ„๋ Œ๋”๋ง ํŽ˜์ด์ง€์˜ ์ผ๋ถ€์ผ ๋•Œ ์œ ์šฉํ•  ์ˆ˜ ์žˆ๋‹ค. ์—ฌ๋Ÿฌ๊ฐœ ๊ฐœ๋ณ„ React ๋ฃจํŠธ๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ๊ฒƒ๋ณด๋‹ค ํฌํ„ธ์„ ์‚ฌ์šฉํ•˜์—ฌ ์•ฑ์˜ ์ผ๋ถ€๊ฐ€ DOM์˜ ๋‹ค๋ฅธ ๋ถ€๋ถ„์— ๋ Œ๋”๋ง ๋˜๋”๋ผ๋„ ์•ฑ์„ ๊ณต์œ  state๋ฅผ ๊ฐ€์ง„ ๋‹จ์ผ React ํŠธ๋ฆฌ๋กœ ์ฒ˜๋ฆฌํ•  ์ˆ˜ ์žˆ๋‹ค.

Rendering React components into non-React DOM nodes

ํฌํ„ธ์„ ์‚ฌ์šฉํ•ด React ์™ธ๋ถ€์—์„œ ๊ด€๋ฆฌ๋˜๋Š” DOM ๋…ธ๋“œ์˜ ์ฝ˜ํ…์ธ ๋ฅผ ๊ด€๋ฆฌํ•  ์ˆ˜๋„ ์žˆ๋‹ค

import { useRef, useEffect, useState } from 'react';
import { createPortal } from 'react-dom';
import { createMapWidget, addPopupToMapWidget } from './map-widget.js';
 
export default function Map() {
  const containerRef = useRef(null);
  const mapRef = useRef(null);
  const [popupContainer, setPopupContainer] = useState(null);
 
  useEffect(() => {
    if (mapRef.current === null) {
      const map = createMapWidget(containerRef.current);
      mapRef.current = map;
      const popupDiv = addPopupToMapWidget(map);
      setPopupContainer(popupDiv);
    }
  }, []);
 
  return (
    <div style={{ width: 250, height: 250 }} ref={containerRef}>
      {popupContainer !== null && createPortal(
        <p>Hello from React!</p>,
        popupContainer
      )}
    </div>
  );
}
 
import 'leaflet/dist/leaflet.css';
import * as L from 'leaflet';
 
export function createMapWidget(containerDomNode) {
  const map = L.map(containerDomNode);
  map.setView([0, 0], 0);
  L.tileLayer('https://tile.openstreetmap.org/{z}/{x}/{y}.png', {
    maxZoom: 19,
    attribution: 'ยฉ OpenStreetMap'
  }).addTo(map);
  return map;
}
 
export function addPopupToMapWidget(map) {
  const popupDiv = document.createElement('div');
  L.popup()
    .setLatLng([0, 0])
    .setContent(popupDiv)
    .openOn(map);
  return popupDiv;
}
 
  • ๋ฆฌ์•กํŠธ ์™ธ๋ถ€์— ์žˆ๋Š” div์˜ ๋‚ด์šฉ์„ ๋ฆฌ์•กํŠธ๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ์ฑ„์›Œ๋„ฃ์„ ์ˆ˜ ์žˆ์Œ