Веб-розробка
Що таке портал у 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
Опануйте фронтенд-розробку на практичних курсах із менторами та реальними проєктами.
Обрати курс