\n\nThese docs are old and won’t be updated. Go to react.dev for the new React docs.
\nThese new documentation pages teach modern React and include live examples:
\n\n
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.
\nQuand 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) où n est le nombre d’éléments dans l’arbre.
\nSi 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 :
\nkey.En pratique, ces hypothèses sont valables dans presque tous les cas.
\nEn comparant deux arbres, React va commencer par comparer les éléments racines. Le comportement est différent selon le type des éléments racines.
\nChaque 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 :
\n<div>\n <Counter />\n</div>\n\n<span>\n <Counter />\n</span>Ça détruira l’ancien Counter puis en remontera un nouveau.
\n\nRemarque
\nLes méthodes suivantes sont considérées dépréciées et vous devriez les éviter dans vos nouveaux codes :
\n\n
\n- \n
UNSAFE_componentWillMount()
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 :
\n<div className=\"before\" title=\"stuff\" />\n\n<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'}} />\n\n<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.
\nLorsqu’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.
\n\nRemarque
\nLes méthodes suivantes sont considérées dépréciées et vous devriez les éviter dans vos nouveaux codes :
\n\n
\n- \n
UNSAFE_componentWillReceiveProps()- \n
UNSAFE_componentWillUpdate()
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.
\nPar exemple, lors de l’ajout d’un élément à la fin des enfants, la conversion entre les deux arbres fonctionne bien :
\n<ul>\n <li>first</li>\n <li>second</li>\n</ul>\n\n<ul>\n <li>first</li>\n <li>second</li>\n <li>third</li>\n</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 :
\n<ul>\n <li>Duke</li>\n <li>Villanova</li>\n</ul>\n\n<ul>\n <li>Connecticut</li>\n <li>Duke</li>\n <li>Villanova</li>\n</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.
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>\n <li key=\"2015\">Duke</li>\n <li key=\"2016\">Villanova</li>\n</ul>\n\n<ul>\n <li key=\"2014\">Connecticut</li>\n <li key=\"2015\">Duke</li>\n <li key=\"2016\">Villanova</li>\n</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 :
\n<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.
\nEn 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.
\nLes 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.
\nVoici 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.
\nRappelez-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.
\nPuisque React se repose sur des heuristiques, si les hypothèses derrière celles-ci s’avèrent erronées, ça réduira les performances.
\nMath.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.