Portals voor modals en tooltips
Gebruik ReactDOM.createPortal om children in een andere DOM-node te renderen, zodat modals en tooltips buiten overflow:hidden-containers kunnen vallen.
Portals voor modals en tooltips is een gratis Frontend Academy-les op CoddyKit. Dit is les 3 van 4. Je kunt de volledige les hieronder gratis lezen en daarna in de browser praktisch oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is. Deze les maakt deel uit van het leertraject Frontend Academy. Je voortgang wordt gesynchroniseerd op het web en in de CoddyKit-app. De cursus Frontend Academy bevat in totaal 4 lessen.
Het probleem van ontsnappende containers
Modale vensters en tooltips moeten bovenaan de DOM worden weergegeven, buiten overflow:hidden, z-index-stapeling en door transform bepaalde contexten van hun ouder. Oplossing: portals.
De createPortal-API
createPortal(children, container) geeft children weer in container, een willekeurige DOM-node, terwijl ze logisch kinderen blijven van de React-component voor gebeurtenissen en context.
import { createPortal } from 'react-dom';
function Modal({ children, onClose }) {
return createPortal(
<div className="modal-backdrop" onClick={onClose}>
<div className="modal-content" onClick={e => e.stopPropagation()}>
{children}
</div>
</div>,
document.body
);
}Containers voor portals
Veelgebruikte doelen zijn: document.body, een speciale #modal-root-div in index.html, of een container met een ref die op aanvraag wordt gemaakt.
<!-- index.html -->
<div id="root"></div>
<div id="modal-root"></div>
// component:
const modalRoot = document.getElementById('modal-root');
return createPortal(<div>...</div>, modalRoot);Waarom niet gewoon inline renderen?
Als een ouder overflow: hidden heeft, wordt een modaal kind afgesneden. Als een ouder transform: scale heeft, wordt de vaste positionering van het modale venster relatief ten opzichte van de ouder. Portals voorkomen dit allemaal.
Gebeurtenissen borrelen nog steeds omhoog
Ondanks dat ze elders in de DOM worden weergegeven, borrelen React-gebeurtenissen door de componentenboom en niet door de DOM-boom. Een klik in de portal borrelt nog steeds naar onClick-handlers op bovenliggende React-componenten.
Sluiten bij een klik op de overlay
Stop de verspreiding van de gebeurtenis op de inhoud van het modale venster, zodat klikken binnenin het venster niet tot sluiten leidt.
function Modal({ onClose, children }) {
return createPortal(
<div className="backdrop" onClick={onClose}>
<div className="content" onClick={e => e.stopPropagation()}>
{children}
</div>
</div>,
document.body
);
}Sluiten met de Escape-toets
Voeg een keydown-listener toe zolang het modale venster open is en verwijder die bij het ontkoppelen.
useEffect(() => {
const onKey = (e) => { if (e.key === 'Escape') onClose(); };
window.addEventListener('keydown', onKey);
return () => window.removeEventListener('keydown', onKey);
}, [onClose]);Focusbeheer in portals
Wanneer een modaal venster opent: verplaats de focus naar binnen, houd de focus gevangen tot het sluiten en herstel daarna de focus naar het element waarmee het venster is geopend. Gebruik een bibliotheek zoals focus-trap-react om dit niet opnieuw te hoeven implementeren.
Het ingebouwde dialog-element
Het HTML-element <dialog> regelt de positionering van modale vensters, de achtergrond, het vasthouden van de focus en sluiten met Escape standaard. Voor de meeste modale vensters is dit een beter vertrekpunt dan een portal.
function Modal({ open, onClose, children }) {
const ref = useRef(null);
useEffect(() => {
if (open) ref.current?.showModal();
else ref.current?.close();
}, [open]);
return (
<dialog ref={ref} onClose={onClose}>
{children}
</dialog>
);
}Tooltips en pop-overs
Tooltips worden ten opzichte van een ankerelement geplaatst. Met een portal kunnen ze aan stapelcontexten ontsnappen. Combineer dit met floating-ui voor botsingsdetectie, omklappen en positionering.
import { useFloating, autoUpdate } from '@floating-ui/react';
function Tooltip({ children, content }) {
const { refs, floatingStyles } = useFloating({ whileElementsMounted: autoUpdate });
const [open, setOpen] = useState(false);
return (
<>
<button ref={refs.setReference} onMouseEnter={() => setOpen(true)} onMouseLeave={() => setOpen(false)}>
{children}
</button>
{open && createPortal(
<div ref={refs.setFloating} style={floatingStyles}>{content}</div>,
document.body
)}
</>
);
}Let op bij SSR
document bestaat niet op de server. Render alleen op de client, controleer typeof window, of gebruik dynamic van Next.js met ssr:false.
Toegankelijkheid: aria-modal
Modale containers moeten role="dialog", aria-modal="true" en aria-labelledby hebben, waarbij aria-labelledby verwijst naar de kop van het modale venster. Of gebruik het ingebouwde <dialog>.
Korte controle
Waarom gebruik je createPortal voor modale vensters in plaats van ze inline in de componentenboom weer te geven?
Samenvatting: portals
createPortal(children, container) geeft de DOM elders weer, terwijl de logische React-boom behouden blijft. Lost problemen met overflow/transform/z-index op. Gebeurtenissen borrelen nog steeds door de React-boom. Voeg sluiten met Escape en focusbeheer toe. Het native <dialog>-element regelt veel hiervan voor modale vensters. Combineer het met floating-ui voor tooltips. Vergeet SSR niet, met een controle van typeof window.
Leer HTML met een AI-tutor — gratis
Schrijf echte code en voer die uit in je browser, krijg direct hulp van een AI-tutor die 24/7 beschikbaar is en ga verder waar je gebleven bent op het web of in de app.
- Cursussen
- 41
- Lessen
- 163
Veelgestelde vragen
Is de les “Portals voor modals en tooltips” gratis?
Ja — de volledige tekst van “Portals voor modals en tooltips” kun je hier gratis op het web lezen. Als je interactief wilt oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is, en de rest van de cursus Frontend Academy wilt ontgrendelen, kun je upgraden naar CoddyKit PRO. De cursus Frontend Academy bevat in totaal 4 lessen.
Wat leer ik in “Portals voor modals en tooltips”?
Gebruik ReactDOM.createPortal om children in een andere DOM-node te renderen, zodat modals en tooltips buiten overflow:hidden-containers kunnen vallen. Je oefent met Frontend Academy door code rechtstreeks in de browser uit te voeren. Een AI-begeleider die 24/7 beschikbaar is beantwoordt je vragen terwijl je de les doorwerkt.
Heb ik ervaring nodig om met Frontend Academy te beginnen?
Ervaring vooraf is niet nodig. Frontend Academy op CoddyKit is opgebouwd voor beginners tot gevorderden, zodat je hier of bij het begin kunt starten en in je eigen tempo kunt leren. Dit is les 3 van 4.
Hoe lang duurt de les “Portals voor modals en tooltips”?
De meeste lessen van CoddyKit duren ongeveer 5–10 minuten. Elke les is kort en interactief, zodat je gestaag vooruitgaat en op het web en in de app precies verdergaat waar je was gebleven.
Kan ik code schrijven en uitvoeren in deze les over Frontend Academy?
Ja. Elke les over Frontend Academy bevat een ingebouwde code-editor, zodat je rechtstreeks in je browser echte code kunt schrijven en uitvoeren en direct feedback van AI krijgt — lokale installatie is niet nodig.
Alle lessen in deze cursus
- Samengestelde componenten met Context
- Render props en HOC-patronen
- Portals voor modals en tooltips
- Error Boundaries