Phone icon Зв'язатись з нами

Веб-розробка

Що таке портал у React?

Портал (React Portal) — це механізм React, який дозволяє відрендерити дочірні елементи в інший DOM-вузол, наприклад одразу в body, хоча в дереві компонентів вони залишаються всередині свого батька. Портал створюють функцією createPortal з пакета react-dom.

Портали вирішують проблему верстки: модальне вікно чи випадне меню всередині картки з overflow: hidden або з власним контекстом накладання може обрізатися чи опинитися під іншими блоками. Винесення в body дозволяє розташувати його поверх усієї сторінки без боротьби з z-index.

Водночас для React портал залишається частиною дерева: компонент усередині порталу отримує контекст і пропси від батька, а події «спливають» до батьківських компонентів React, хоча в DOM вони розташовані в іншому місці.

Де застосовується

Портали використовують для модальних вікон і діалогів, підказок (tooltip) і поповерів, випадних меню й автодоповнення, сповіщень (toast), а також для вставки віджетів у зовнішні частини сторінки, наприклад у шапку, якою керує інший код.

Бібліотеки компонентів — Material UI, Radix UI, Headless UI — використовують портали всередині своїх модальних вікон і меню. Для доступності модальне вікно в порталі має керувати фокусом і закриватися клавішею Esc; інша можливість — нативний тег dialog.

Приклад

Модальне вікно, винесене з картки з overflow: hidden у body.

import { createPortal } from 'react-dom';

function Modal({ open, onClose, children }) {
  if (!open) return null;
  return createPortal(
    <div className="overlay" onClick={onClose}>
      <div className="modal" role="dialog" aria-modal="true"
           onClick={e => e.stopPropagation()}>
        {children}
        <button onClick={onClose}>Close</button>
      </div>
    </div>,
    document.body
  );
}

function CourseCard() {
  const [open, setOpen] = useState(false);
  return (
    <div className="card" style={{ overflow: 'hidden' }}>
      <button onClick={() => setOpen(true)}>Enroll</button>
      <Modal open={open} onClose={() => setOpen(false)}>Lead form</Modal>
    </div>
  );
}
createPortal і обробка кліку поза вікном.

Часті запитання

Чи працюють обробники подій у порталі?

Так. Події з елементів порталу спливають по дереву React-компонентів, а не DOM, тому батьківський компонент може їх отримати. Іноді це несподівано, і спливання зупиняють через stopPropagation.

Чи потрібен портал, якщо є тег dialog?

Нативний dialog з методом showModal() теж відображається поверх усієї сторінки й керує фокусом. Тому для модальних вікон його можна використовувати без порталу, а портали залишаються корисними для підказок, меню й сповіщень.

Чи можна робити портал під час серверного рендерингу?

На сервері немає document, тому портали рендерять лише в браузері — наприклад, після монтування компонента.

Навчання фронтенд-розробці в OWU

Опануйте фронтенд-розробку на практичних курсах із менторами та реальними проєктами.

Обрати курс