Formations — 1 037 leçons en français

Accueil › React › La règle des clés

La règle des clés

Listes et affichage conditionneldebutant

React ne rend pas une liste depuis zéro à chaque fois. Il compare le nouveau rendu au précédent et en déduit le minimum à changer dans le DOM. Pour cela, il doit savoir quel élément d'avant correspond à quel élément de maintenant. C'est le rôle de key.

{taches.map((tache) => (
  <Tache key={tache.id} tache={tache} />
))}

Sans clé, React apparie les enfants par position : le premier avec le premier, le deuxième avec le deuxième. Cela marche tant que la liste ne bouge pas. Dès qu'un élément est inséré, supprimé ou déplacé, les positions mentent.

// ❌ la clé est la position, pas la tâche
{taches.map((tache, i) => (
  <li key={i}>
    <input type="checkbox" /> {tache.titre}
  </li>
))}

Supprimez la première tâche : la deuxième prend la clé 0. React croit reconnaître l'élément de tout à l'heure, réutilise son nœud du DOM — et la case cochée reste là, attachée à la mauvaise tâche.

Une bonne clé est stable (attachée à la donnée, pas à sa position), unique parmi ses frères et sœurs, et immuable (jamais recalculée au rendu). Un identifiant de base de données est le cas idéal.

Les termes à connaître

key

Une prop spéciale qui donne une identité à un élément de liste. React s'en sert pour savoir quel élément d'un rendu correspond à quel élément du précédent.

Réconciliation

La comparaison que React fait entre l'arbre précédent et le nouveau, pour en déduire les modifications minimales à appliquer au DOM.

Identité d'un élément

Ce qui fait qu'un élément est « le même » d'un rendu à l'autre. Dans une liste, c'est la clé — et rien d'autre.

Clé stable

Une clé attachée à la donnée, pas à sa position : un identifiant de base, une référence, un slug. Elle suit l'élément quand la liste bouge.

État non contrôlé

Un état détenu par le DOM ou par un composant enfant — texte saisi, case cochée, focus, position de défilement. C'est lui que de mauvaises clés déplacent.

Clé générée

Un identifiant créé une fois, au moment où l'élément entre dans la liste, et stocké avec lui. Il ne doit jamais être recalculé au rendu.

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.