Skip to content

Commit

Permalink
Apply suggestions from code review
Browse files Browse the repository at this point in the history
Co-Authored-By: Geslain <geslain.dahan@gmail.com>
  • Loading branch information
tdd and Geslain authored Mar 1, 2019
1 parent 99e5ec0 commit c11133e
Showing 1 changed file with 19 additions and 19 deletions.
38 changes: 19 additions & 19 deletions content/docs/reference-react-dom-server.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ category: Reference
permalink: docs/react-dom-server.html
---

L’objet `ReactDOMServer` vous permet d’afficher des composants sous forme de balises statiques. En règle générale, on l’utilise avec un serveur Node :
L’objet `ReactDOMServer` vous permet de produire sous forme de texte statique le balisage nécessaire à l’affichage de composants. En règle générale, on l’utilise avec un serveur Node :

```js
// Modules ES
Expand All @@ -17,29 +17,29 @@ var ReactDOMServer = require('react-dom/server');

## Aperçu {#overview}

Les méthodes suivantes peuvent être utilisées à la fois dans des environnements navigateurs et serveurs :
Les méthodes suivantes peuvent être utilisées aussi bien dans des environnements navigateurs et serveurs :

- [`renderToString()`](#rendertostring)
- [`renderToStaticMarkup()`](#rendertostaticmarkup)

Les méthodes additionnelles suivantes dépendent du package (`stream`) **disponible uniquement pour serveurs**, elles ne fonctionneront pas dans un navigateur.
Les méthodes suivantes dépendent d’un module (`stream`) **disponible uniquement côté serveur**, elles ne fonctionneront donc pas dans un navigateur.

- [`renderToNodeStream()`](#rendertonodestream)
- [`renderToStaticNodeStream()`](#rendertostaticnodestream)

* * *

## Référence {#reference}
## Référence de l'API {#reference}

### `renderToString()` {#rendertostring}

```javascript
ReactDOMServer.renderToString(element)
```

Crée le rendu d’un élément React sous sa forme HTML initiale. React va se charger de retourner une chaîne de charactères HTML. Vous pouvez utiliser cette méthode pour générer du HTML coté serveur et renvoyer le balisage en guise de réponse à la requête initiale, pour accélérer le chargement des pages et permettre aux moteurs de recherche d’analyser vos pages pour les référencer.
Produit le HTML initial d’un élément React, sous forme d’une chaîne de caractères. Vous pouvez utiliser cette méthode pour générer du HTML coté serveur et le renvoyer en réponse à la requête initiale, afin d’accélérer le chargement des pages et de permettre aux moteurs de recherche d’analyser vos pages dans une optique de référencement naturel *(SEO, NdT)*.

Si vous appelez [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) sur un nœud dont le balisage a déjà été généré par le serveur, React le conservera et n’y attachera que des gestionnaires d’événements, ce qui vous permettra d’avoir une expérience de premier chargement des plus performantes.
Si vous appelez [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) sur un nœud dont le balisage a déjà été généré par le serveur, React le conservera et se contentera d’y attacher les gestionnaires d’événements, ce qui vous permettra d’avoir une expérience de chargement initial des plus performantes.

* * *

Expand All @@ -49,9 +49,9 @@ Si vous appelez [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) sur un nœu
ReactDOMServer.renderToStaticMarkup(element)
```

Similaire à [`renderToString`](#rendertostring), si ce n’est qu’elle ne crée pas d’attributs supplémentaires utilisés par React en interne, à l’image de `data-reactroot`. Ça peut être pratique si vous souhaitez utiliser React comme simple générateur de pages statiques, supprimer les attributs supplémentaires vous économisant quelques octets.
Similaire à [`renderToString`](#rendertostring), si ce n’est qu’elle ne crée pas d’attributs supplémentaires utilisés par React en interne, tels que `data-reactroot`. Ça peut être pratique si vous souhaitez utiliser React comme simple générateur de pages statiques, car supprimer les attributs supplémentaires économise quelques octets.

Il n’est pas recommandé d’utiliser cette méthode si vous envisagez d’utiliser React coté client pour rendre le balisage interactif. À la place, utilisez [`renderToString`](#rendertostring) coté serveur, et [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) coté client.
N’utilisez pas cette méthode si vous envisagez d’utiliser React côté client pour rendre le contenu interactif. Préférez [`renderToString`](#rendertostring) côté serveur, et [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) côté client.

* * *

Expand All @@ -61,15 +61,15 @@ Il n’est pas recommandé d’utiliser cette méthode si vous envisagez d’uti
ReactDOMServer.renderToNodeStream(element)
```

Crée le rendu d’un élément React sous sa forme HTML initiale. Retourne un [Readable stream](https://nodejs.org/api/stream.html#stream_readable_streams) qui génère une chaîne de caractères HTML. La sortie HTML de ce flux est précisément égale à ce que [`ReactDOMServer.renderToString`](#rendertostring) renverrait. Vous pouvez utiliser cette méthode pour générer du HTML coté serveur et renvoyer le balisage en guise se réponse à la requête initiale, pour accélérer le chargement des pages et permettre aux moteurs de recherche d’analyser vos pages pour les référencer.
Produit le HTML initial d’un élément React. Renvoie un [flux en lecture](https://nodejs.org/api/stream.html#stream_readable_streams) (`Readable`) qui génère une chaîne de caractères HTML. La sortie HTML de ce flux est identique à ce que [`ReactDOMServer.renderToString`](#rendertostring) renverrait. Vous pouvez utiliser cette méthode pour générer du HTML coté serveur et le renvoyer en réponse à la requête initiale, afin d’accélérer le chargement des pages et de permettre aux moteurs de recherche d’analyser vos pages dans une optique de référencement naturel.

Si vous appelez [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) sur un nœud dont le balisage a déjà été généré par le serveur, React le conservera et n’y attachera que des gestionnaires d’événements, ce qui vous permettra d’avoir une expérience de premier chargement des plus performantes.
Si vous appelez [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) sur un nœud dont le balisage a déjà été généré par le serveur, React le conservera et se contentera d’y attacher les gestionnaires d’événements, ce qui vous permettra d’avoir une expérience de chargement initial des plus performantes.

> Note :
> Remarque :
>
> Pour serveur uniquement. Cette API n’est pas disponible pour navigateur.
> Côté serveur uniquement. Cette API n’est pas disponible côté navigateur.
>
> Le flux renvoyé par cette méthode renverra un flux d’octets encodés en utf-8. Si vous avez besoin d’un flux dans un autre encodage, jetez un coup d’œil au projet [iconv-lite](https://www.npmjs.com/package/iconv-lite), qui fournit des flux de transformation pour le transcodage de texte.
> Le flux renvoyé par cette méthode est encodé en UTF-8. Si vous avez besoin d’un autre encodage, jetez un œil au projet [iconv-lite](https://www.npmjs.com/package/iconv-lite), qui fournit des flux de transformation pour le transcodage de texte.
* * *

Expand All @@ -79,14 +79,14 @@ Si vous appelez [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) sur un nœu
ReactDOMServer.renderToStaticNodeStream(element)
```

Similaire à [`renderToNodeStream`](#rendertonodestream), si ce n’est qu’elle ne crée pas d’attributs supplémentaires utilisés par React en interne, à l’image de `data-reactroot`. Ça peut être pratique si vous souhaitez utiliser React comme simple générateur de pages statiques, supprimer les attributs supplémentaires vous économisant quelques octets.
Similaire à [`renderToNodeStream`](#rendertonodestream), si ce n’est qu’elle ne crée pas d’attributs supplémentaires utilisés par React en interne, tels que `data-reactroot`. Ça peut être pratique si vous souhaitez utiliser React comme simple générateur de pages statiques, car supprimer les attributs supplémentaires économise quelques octets.

La sortie HTML de ce flux est précisément égale à ce que [`ReactDOMServer.renderToStaticMarkup`](#rendertostaticmarkup) renverrait.
La sortie HTML de ce flux est identique à ce que [`ReactDOMServer.renderToStaticMarkup`](#rendertostaticmarkup) renverrait.

Il n’est pas recommandé d’utiliser cette méthode si vous envisagez d’utiliser React coté client pour rendre le balisage interactif. À la place, utilisez [`renderToNodeStream`](#rendertonodestream) coté serveur, et [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) coté client.
N’utilisez pas cette méthode si vous envisagez d’utiliser React côté client pour rendre le contenu interactif. Préférez [`renderToNodeStream`](#rendertonodestream) côté serveur, et [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) côté client.

> Note :
> Remarque :
>
> Pour serveur uniquement. Cette API n’est pas disponible pour navigateur.
Côté serveur uniquement. Cette API n’est pas disponible côté navigateur.
>
> Le flux renvoyé par cette méthode renverra un flux d’octets encodés en utf-8. Si vous avez besoin d’un flux dans un autre encodage, jetez un coup d’œil au projet [iconv-lite](https://www.npmjs.com/package/iconv-lite), qui fournit des flux de transformation pour le transcodage de texte.
> Le flux renvoyé par cette méthode est encodé en UTF-8. Si vous avez besoin d’un autre encodage, jetez un œil au projet [iconv-lite](https://www.npmjs.com/package/iconv-lite), qui fournit des flux de transformation pour le transcodage de texte.

0 comments on commit c11133e

Please sign in to comment.