We want to hear from you!Take our 2021 Community Survey!
This site is no longer updated.Go to react.dev

Réconciliation

These docs are old and won’t be updated. Go to react.dev for the new React docs.

These new documentation pages teach modern React and include live examples:

React fournit une API déclarative afin que vous n’ayez pas à vous soucier de savoir ce qui change exactement lors de chaque mise à jour. Ça facilite grandement l’écriture d’applications, mais la manière dont React s’y prend n’est pas forcément évidente. Cet article explique les choix que nous avons faits dans l’algorithme de comparaison de façon à rendre prévisibles les mises à jour des composants tout en restant suffisamment rapide pour des applications à hautes performances.

Raisons

Quand vous utilisez React, à chaque instant précis vous pouvez considérer que la fonction render() crée un arbre d’éléments React. Lors de la mise à jour suivante de l’état local ou des props, cette fonction render() renverra un arbre différent d’éléments React. React doit alors déterminer comment mettre efficacement à jour l’interface utilisateur (UI) pour qu’elle corresponde à l’arbre le plus récent.

Il existe des solutions génériques à ce problème algorithmique consistant à générer le nombre minimal d’opérations pour transformer un arbre en un autre. Néanmoins, les algorithmes à la pointe de l’état de l’art (en anglais) ont une complexité de l’ordre de O(n3)n est le nombre d’éléments dans l’arbre.

Si nous les utilisions dans React, l’affichage de 1 000 éléments nécessiterait environ un milliard d’opérations. C’est beaucoup trop coûteux. React implémente plutôt un algorithme heuristique en O(n) basé sur deux hypothèses :

  1. Deux éléments de types différents produiront des arbres différents.
  2. Le développeur peut indiquer quels éléments peuvent être stables d’un rendu à l’autre grâce à la prop key.

En pratique, ces hypothèses sont valables dans presque tous les cas.

L’algorithme de comparaison

En comparant deux arbres, React va commencer par comparer les éléments racines. Le comportement est différent selon le type des éléments racines.

Éléments de types différents

Chaque fois que les éléments racines ont des types différents, React va détruire l’ancien arbre et reconstruire le nouvel arbre à partir de zéro. Passer de <a> à <img>, ou de <Article> à <Comment>, ou de <Button> à <div> : tous aboutiront à une reconstruction complète.

Lors de la destruction d’un arbre, les anciens nœuds DOM sont détruits. Les instances des composants reçoivent componentWillUnmount(). Lors de la construction d’un nouvel arbre, les nouveaux nœuds sont insérés dans le DOM. Les instances de composants reçoivent UNSAFE_componentWillMount() puis componentDidMount(). Tous les états associés à l’ancien arbre sont perdus.

Tous les composants au-dessous de la racine seront également démontés et leur état détruit. Par exemple, en comparant :

<div>
  <Counter />
</div>

<span>
  <Counter />
</span>

Ça détruira l’ancien Counter puis en remontera un nouveau.

Remarque

Les méthodes suivantes sont considérées dépréciées et vous devriez les éviter dans vos nouveaux codes :

  • UNSAFE_componentWillMount()

Éléments DOM de même type

Lors de la comparaison entre deux éléments DOM React de même type, React examine les attributs des deux, conserve le même nœud DOM sous-jacent, et ne met à jour que les attributs modifiés. Par exemple :

<div className="before" title="stuff" />

<div className="after" title="stuff" />

En comparant ces deux éléments, React sait qu’il ne faut modifier que le className du nœud DOM sous-jacent.

Lors d’une mise à jour du style, React là aussi sait ne mettre à jour que les propriétés qui ont changé. Par exemple :

<div style={{color: 'red', fontWeight: 'bold'}} />

<div style={{color: 'green', fontWeight: 'bold'}} />

Lors de la conversion entre les deux éléments, React sait qu’il ne doit modifier que le style color et pas fontWeight.

Après avoir manipulé le nœud DOM, React applique le même traitement sur les enfants.

Éléments composants de même type

Lorsqu’un composant est mis à jour, l’instance reste la même, afin que l’état soit maintenu d’un rendu à l’autre. React met à jour les props de l’instance de composant sous-jacente pour correspondre au nouvel élément, et appelle UNSAFE_componentWillReceiveProps(), UNSAFE_componentWillUpdate() et componentDidUpdate() dessus.

Ensuite, la méthode render() est appelée et l’algorithme de comparaison reprend entre son résultat précédent et le nouveau.

Remarque

Les méthodes suivantes sont considérées dépréciées et vous devriez les éviter dans vos nouveaux codes :

  • UNSAFE_componentWillReceiveProps()
  • UNSAFE_componentWillUpdate()

Traitement récursif sur les enfants

Par défaut, lorsqu’il traite les enfants d’un nœud DOM, React parcourt simultanément les deux listes d’enfants et génère une modification chaque fois qu’il y a une différence.

Par exemple, lors de l’ajout d’un élément à la fin des enfants, la conversion entre les deux arbres fonctionne bien :

<ul>
  <li>first</li>
  <li>second</li>
</ul>

<ul>
  <li>first</li>
  <li>second</li>
  <li>third</li>
</ul>

React fera correspondre les deux arbres <li>first</li>, les deux arbres <li>second</li>, et insérera l’arbre <li>third</li>.

Si vous l’implémentez de façon naïve, l’insertion d’un élément au début aura de moins bonnes performances. Par exemple, la conversion entre ces deux arbres fonctionnera assez mal :

<ul>
  <li>Duke</li>
  <li>Villanova</li>
</ul>

<ul>
  <li>Connecticut</li>
  <li>Duke</li>
  <li>Villanova</li>
</ul>

React va modifier chaque enfant plutôt que de réaliser qu’il pouvait garder les sous-arbres <li>Duke</li> et <li>Villanova</li> intacts. Cette inefficacité peut être un problème.

Clés

Afin de résoudre ce problème, React prend en charge l’attribut key. Quand des enfants ont cette clé, React l’utilise pour faire correspondre les enfants de l’arbre d’origine avec les enfants de l’arbre suivant. Par exemple, l’ajout d’une key dans notre exemple inefficace peut rendre la conversion de l’arbre plus efficace :

<ul>
  <li key="2015">Duke</li>
  <li key="2016">Villanova</li>
</ul>

<ul>
  <li key="2014">Connecticut</li>
  <li key="2015">Duke</li>
  <li key="2016">Villanova</li>
</ul>

À présent, React sait que l’élément avec la clé '2014' est nouveau, et que les éléments avec les clés '2015' et '2016' ont juste été déplacés.

En pratique, trouver une clé n’est généralement pas difficile. L’élément que vous allez afficher peut déjà disposer d’un identifiant unique, la clé provenant alors de vos données :

<li key={item.id}>{item.name}</li>

Quand ce n’est pas le cas, vous pouvez ajouter une nouvelle propriété d’identification à votre modèle, ou hacher certaines parties de votre contenu pour générer une clé. La clé n’a besoin d’être unique que parmi ses éléments frères, et non au niveau global.

En dernier recours, vous pouvez utiliser l’index de l’élément dans un tableau comme clé. Cela fonctionne correctement si les éléments ne sont jamais réordonnés et s’il n’y a ni insertion ni suppression, dans le cas contraire ce serait assez lent.

Les tris peuvent également causer des problèmes avec les états des composants quand les index sont utilisés comme des clés. Les instances des composants sont mises à jour et réutilisées en fonction de leur clé. Si la clé est un index, déplacer un élément changera sa clé. En conséquence, l’état local des composants utilisés pour des saisies non-contrôlées peut s’emmêler et être mis à jour de manière inattendue.

Voici un exemple sur CodePen des problèmes qui peuvent être causés en utilisant des index comme clés. Voilà une version mise à jour du même exemple montrant comment, en évitant d'utiliser les index comme clés, on résoudra ces problèmes de réordonnancement, de tri et d'insertion.

Compromis

Rappelez-vous bien que l’algorithme de réconciliation est un détail d’implémentation. React pourrait rafraîchir l’ensemble de l’application à chaque action ; le résultat final serait le même. Pour être clair, rafraîchir dans ce contexte signifie appeler render sur tous les composants, ça ne signifie pas que React les démontera et remontera. Il n’appliquera que les différences obtenues en suivant les règles énoncées dans les sections précédentes.

Nous affinons régulièrement les heuristiques afin d’accélérer les cas d’usage courants. Dans l’implémentation actuelle, vous pouvez exprimer le fait qu’un sous-arbre a été déplacé parmi ses frères, mais vous ne pouvez pas dire qu’il a été déplacé ailleurs. L’algorithme va refaire le rendu de l’ensemble du sous-arbre.

Puisque React se repose sur des heuristiques, si les hypothèses derrière celles-ci s’avèrent erronées, ça réduira les performances.

  1. L’algorithme n’essaiera pas de faire correspondre des sous-arbres de types de composants différents. Si vous êtes amené·e à alterner entre deux types de composants au rendu très similaire, vous devriez peut-être en faire un type unique. En pratique, nous ne considérons pas ça comme un problème.
  2. Les clés doivent être stables, prévisibles et uniques. Des clés instables (comme celles produites par Math.random()) entraîneront la re-création superflue de nombreuses instances de composants et de nœuds DOM, ce qui peut dégrader les performances et perdre l’état local des composants enfants.
Avez-vous trouvé cette page utile ?Modifier cette page