Formations — 1 037 leçons en français

Accueil › React › useRef, la valeur qui ne redessine pas

useRef, la valeur qui ne redessine pas

Les hooks personnalisésintermediaire

const monRef = useRef(valeurInitiale);
monRef.current;              // lire
monRef.current = x;          // écrire — AUCUN rendu

C'est toute la différence avec useState : modifier une référence ne redessine rien.

Usage 1 — accéder à un élément

function Formulaire() {
  const champ = useRef(null);

  useEffect(() => {
    champ.current?.focus();        // après le montage
  }, []);

  return <input ref={champ} />;
}

current vaut null au premier rendu : l'élément n'existe pas encore. React le remplit après la création du nœud — d'où l'accès dans un effet, jamais pendant le rendu.

Usage 2 — une valeur qui ne doit pas redessiner

function Chrono() {
  const [secondes, setSecondes] = useState(0);
  const minuteur = useRef(null);

  function demarrer() {
    if (minuteur.current) return;                 // déjà lancé
    minuteur.current = setInterval(() => setSecondes((s) => s + 1), 1000);
  }

  function arreter() {
    clearInterval(minuteur.current);
    minuteur.current = null;
  }

  useEffect(() => arreter, []);                   // nettoyage au démontage
  return <p>{secondes}</p>;
}

L'identifiant du minuteur ne s'affiche pas : il n'a rien à faire dans un état. Un useState provoquerait un rendu inutile à chaque démarrage.

La règle de choix

Si la valeur s'affiche, c'est un état. Si elle ne sert qu'au code, c'est une référence.

Ne jamais afficher ref.current

// ❌ la valeur affichée ne se mettra pas à jour
return <p>{compteur.current}</p>;

Modifier la référence ne redessine pas : l'écran garde l'ancienne valeur, et le bogue paraît venir de nulle part.

Les termes à connaître

useRef

Rend un objet stable dont la propriété current se modifie librement. La modifier ne déclenche aucun rendu.

Objet stable

Le même objet à chaque rendu. C'est ce qui permet de s'en servir comme mémoire entre deux rendus.

Référence au DOM

L'usage le plus visible : ref={monRef} sur un élément met le nœud dans current après le montage.

Valeur mutable

L'autre usage : garder un identifiant de minuteur, un compteur de requêtes, la valeur précédente. Tout ce qui ne doit pas redessiner.

null initial

Une référence au DOM vaut null au premier rendu : l'élément n'existe pas encore. Elle n'est remplie qu'après le montage.

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.