Веб-разработка
Что такое портал в 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>
);
}
Частые вопросы
Работают ли обработчики событий в портале?
Да. События из элементов портала всплывают по дереву React-компонентов, а не DOM, поэтому родительский компонент может их получить. Иногда это неожиданно, и всплытие останавливают через stopPropagation.
Нужен ли портал, если есть тег dialog?
Нативный dialog с методом showModal() тоже отображается поверх всей страницы и управляет фокусом. Поэтому для модальных окон его можно использовать без портала, а порталы остаются полезными для подсказок, меню и уведомлений.
Можно ли делать портал при серверном рендеринге?
На сервере нет document, поэтому порталы рендерят только в браузере — например, после монтирования компонента.
Обучение фронтенд-разработке в OWU
Освойте фронтенд-разработку на практических курсах с менторами и реальными проектами.
Выбрать курс