You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/content/reference/react-dom/client/hydrateRoot.md
+7-7Lines changed: 7 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -35,9 +35,9 @@ React s'attachera au HTML existant à l'intérieur de `domNode`, et prendra la m
35
35
36
36
#### Paramètres {/*parameters*/}
37
37
38
-
* `domNode` : un [élément DOM](https://developer.mozilla.org/fr/docs/Web/API/Element) produit comme élément racine côté serveur.
38
+
* `domNode` : un [élément DOM](https://developer.mozilla.org/fr/docs/Web/API/Element) généré comme élément racine côté serveur.
39
39
40
-
* `reactNode` : un *nœud React* utilisé pour afficher le HTML existant. Ce sera généralement un bout de JSX du genre `<App />`, produit via une méthode `ReactDOM Server` telle que `renderToPipeableStream(<App />)`.
40
+
* `reactNode` : un *nœud React* utilisé pour afficher le HTML existant. Ce sera généralement un bout de JSX du genre `<App />`, généré *via* une méthode [`react-dom/server`](/reference/react-dom/server) telle que `renderToPipeableStream(<App />)`.
41
41
42
42
* `options` **optionnelles** : un objet avec des options pour la racine React.
Ça hydratera le HTML issu du serveur au sein du <CodeStep step={1}>nœud DOM du navigateur</CodeStep> en utilisant le <CodeStep step={2}>composant React</CodeStep> de votre appli. En général, vous ne le ferez qu'une fois au démarrage. Si vous utilisez un framework, il le fait peut-être pour vous sous le capot.
130
130
131
-
Pour hydrater votre appli, React « attachera » la logique de vos composant au HTML initial généré par le serveur. L'hydratation transforme cet instantané initial du HTML, issu du serveur, en une appli pleinement interactive s'exécutant dans le navigateur.
131
+
Pour hydrater votre appli, React « attachera » la logique de vos composants au HTML initial généré par le serveur. L'hydratation transforme cet instantané initial du HTML, issu du serveur, en une appli pleinement interactive s'exécutant dans le navigateur.
132
132
133
133
<Sandpack>
134
134
@@ -179,18 +179,18 @@ Vous ne devriez pas avoir besoin de rappeler `hydrateRoot` ou de l'appeler aille
179
179
180
180
<Pitfall>
181
181
182
-
L'arbre React que vous passez à `hydrateRoot` doit produire **le même résultat** que celui produit côté serveur.
182
+
L'arbre React que vous passez à `hydrateRoot` doit produire **le même résultat** que celui issu du HTML généré côté serveur.
183
183
184
184
C'est important pour l'expérience utilisateur. L'utilisateur passera un peu de temps à regarder le HTML produit par le serveur avant que votre code JavaScript n'ait fini de charger. Le rendu côté serveur donne l'impression que l'appli se charge plus vite, en produisant un instantané du HTML. Afficher soudainement un contenu différent casse cette perception. C'est pourquoi le rendu côté serveur doit correspondre au résultat du rendu initial côté client.
185
185
186
186
Les causes les plus fréquentes d'erreurs d'hydratation sont notamment :
187
187
188
188
* Des espacements supplémentaires (tels que des sauts de lignes) autour du HTML généré par React au sein du nœud racine.
189
189
* L'utilisation de tests du style `typeofwindow!=='undefined'` dans votre code de rendu.
190
-
* Le recours à des API strictement navigateur telles que [`window.matchMedia`](https://developer.mozilla.org/fr/docs/Web/API/Window/matchMedia) dans votre code de rendu.
190
+
* Le recours à des API strictement navigateur, comme par exemple [`window.matchMedia`](https://developer.mozilla.org/fr/docs/Web/API/Window/matchMedia), dans votre code de rendu.
191
191
* L'affichage de données différentes coté serveur et côté client.
192
192
193
-
React peut se remettre de certaines erreurs d'hydratation, mais **vous devez les corriger comme si c'étaient des bugs**. Dans le meilleur des cas, elles ralentiront simplement l'hydratation ; plus gravement, elles pourraient entraîner l'association de gestionnaires d'événements aux mauvais éléments.
193
+
React peut se remettre de certaines erreurs d'hydratation, mais **vous devez les corriger comme si c'étaient des bugs**. Dans le meilleur des cas, elles ralentiront simplement l'hydratation ; mais elles pourraient aussi entraîner l'association de gestionnaires d'événements aux mauvais éléments.
194
194
195
195
</Pitfall>
196
196
@@ -218,7 +218,7 @@ function App() {
218
218
}
219
219
```
220
220
221
-
Pour hydrater le document entier, passez la variable globale [`document`](https://developer.mozilla.org/fr/docs/Web/API/Window/document) comme premier argument de`hydrateRoot` :
221
+
Pour hydrater le document entier, passez la variable globale [`document`](https://developer.mozilla.org/fr/docs/Web/API/Window/document) comme premier argument dans votre appel à`hydrateRoot` :
0 commit comments