Formations — 1 037 leçons en français

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 ref dans ses props comme n'importe quelle autre valeur. forwardRef n'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 avec null.

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 : className se concatène, les gestionnaires s'enchaînent, style se fusionne, le reste écrase.

Lire l'explication détaillée et faire le quiz →

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.