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

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

Выбрать курс