Accueil › React › Portails et refs
Portails et refs
Patterns de compositionavance
Un portail déplace le nœud, pas le composant
import { createPortal } from "react-dom";
function Dialogue({ enfants, onFermer }) {
return createPortal(
<div className="voile" onClick={onFermer}>
<div className="dialogue">{enfants}</div>
</div>,
document.body
);
}
Le DOM place ce balisage sous <body>. React, lui, le laisse exactement là où
il est écrit : le contexte est hérité, l'état survit, et les événements React
remontent chez les ancêtres React, pas chez les ancêtres DOM.
C'est ce qui règle le problème pour lequel les portails existent : un parent
avec overflow: hidden ou un z-index dans un contexte d'empilement coupait
le menu. Hors de ce parent, plus de découpe.
La ref est une prop ordinaire
// React 19
function Champ({ ref, label, ...reste }) {
return (
<label>
{label}
<input ref={ref} {...reste} />
</label>
);
}
// <Champ ref={refSaisie} label="Nom" /> fonctionne sans forwardRef
forwardRef reste fonctionnel mais est déprécié. Le code existant se convertit
mécaniquement : enlever l'enveloppe, ajouter ref dans la déstructuration,
retirer le second paramètre. Aucun appelant ne change, puisqu'ils
écrivaient déjà ref={…}.
Exposer moins que le nœud
function Champ({ ref }) {
const interne = useRef(null);
useImperativeHandle(ref, () => ({
focus: () => interne.current.focus(),
}));
return <input ref={interne} />;
}
L'appelant obtient focus() et rien d'autre. Sans cela il reçoit le nœud
entier et peut en changer la valeur, les classes, le contenu — un couplage dont
le composant ne se débarrassera plus.
Les termes à connaître
- Portail
createPortal(enfants, conteneur)rend des enfants dans un autre nœud du DOM, tout en les laissant à leur place dans l'arbre React — contexte, état et propagation des événements React suivent l'arbre React.- ref comme prop
Depuis React 19, un composant fonction reçoit
refdans ses props comme n'importe quelle autre valeur.forwardRefn'est plus nécessaire et est déclaré déprécié.- ref de rappel
Une fonction passée à
ref, appelée avec le nœud au montage. Depuis React 19, elle peut renvoyer une fonction de nettoyage, appelée au démontage à la place du second appel avecnull.- useImperativeHandle
Le hook qui remplace le nœud exposé par un objet choisi —
{ focus, scrollEnVue }— pour ne pas livrer tout le nœud DOM à l'appelant.- Fusion de refs
Le besoin qui apparaît dès qu'un composant veut garder une référence sur son nœud et la transmettre à l'appelant. Deux refs sur un même élément exigent une ref de rappel qui alimente les deux.
- Fusion de props
Transmettre les props d'un appelant à un élément interne sans perdre les siennes :
classNamese concatène, les gestionnaires s'enchaînent,stylese fusionne, le reste écrase.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.