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.
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.