Skip to content

Commit bc7985e

Browse files
authored
Merge pull request #630 from reactjs/copy/new-dom-functions
L10n: new DOM functions (asset preloading)
2 parents 6ce9105 + 148e790 commit bc7985e

File tree

8 files changed

+196
-196
lines changed

8 files changed

+196
-196
lines changed

src/content/reference/react-dom/components/link.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ Pour établir un lien vers des ressources externes telles que des feuilles de st
4343

4444
Ces props sont disponibles lorsque `rel="stylesheet"` :
4545

46-
* `precedence` : une chaîne de caractères. Indique à React où placer le nœud DOM `<link>` par rapport aux autres présents dans le `<head>` du document, ce qui détermine quelle feuille de style a priorité sur quelle autre. La valeur peur être (par ordre de précédence) `"reset"`, `"low"`, `"medium"` ou `"high"`. Les feuilles de style de même précédence sont regroupées, qu'il s'agisse de balises `<link>` ou `<style>`, y compris si elles sont chargées *via* les fonctions [`preload`](/reference/react-dom/preload) ou [`preinit`](/reference/react-dom/preinit).
46+
* `precedence` : une chaîne de caractères. Indique à React où placer le nœud DOM `<link>` par rapport aux autres présents dans le `<head>` du document, ce qui détermine quelle feuille de styles a priorité sur quelle autre. La valeur peut être (par ordre de précédence) `"reset"`, `"low"`, `"medium"` ou `"high"`. Les feuilles de style de même précédence sont regroupées, qu'il s'agisse de balises `<link>` ou `<style>`, y compris si elles sont chargées *via* les fonctions [`preload`](/reference/react-dom/preload) ou [`preinit`](/reference/react-dom/preinit).
4747
* `media` : une chaîne de caractères. Restreint la feuille de styles à une [media query](https://developer.mozilla.org/fr/docs/Web/CSS/CSS_media_queries/Using_media_queries) spécifique.
4848
* `title` : une chaîne de caractères. Indique le nom d'une [feuille de styles alternative](https://developer.mozilla.org/fr/docs/Web/CSS/Alternative_style_sheets).
4949

src/content/reference/react-dom/components/style.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ Pour ajouter une feuille de styles définie à la volée dans votre document, ut
4040
`<style>` prend en charge toutes les [props communes aux éléments](/reference/react-dom/components/common#props).
4141

4242
* `children` : une chaîne de caractères, obligatoire. Le code source de la feuille de styles définie à la volée.
43-
* `precedence` : une chaîne de caractères. Indique à React où placer le nœud DOM `<style>` par rapport aux autres présents dans le `<head>` du document, ce qui détermine quelle feuille de styles a priorité sur quelle autre. La valeur peur être (par ordre de précédence) `"reset"`, `"low"`, `"medium"` ou `"high"`. Les feuilles de styles de même précédence sont regroupées, qu'il s'agisse de balises `<link>` ou `<style>`, y compris si elles sont chargées *via* les fonctions [`preload`](/reference/react-dom/preload) ou [`preinit`](/reference/react-dom/preinit).
43+
* `precedence` : une chaîne de caractères. Indique à React où placer le nœud DOM `<style>` par rapport aux autres présents dans le `<head>` du document, ce qui détermine quelle feuille de styles a priorité sur quelle autre. La valeur peut être (par ordre de précédence) `"reset"`, `"low"`, `"medium"` ou `"high"`. Les feuilles de styles de même précédence sont regroupées, qu'il s'agisse de balises `<link>` ou `<style>`, y compris si elles sont chargées *via* les fonctions [`preload`](/reference/react-dom/preload) ou [`preinit`](/reference/react-dom/preinit).
4444
* `href` : une chaîne de caractères. Permet à React de [dédoublonner les styles](#special-rendering-behavior) qui auraient le même `href`.
4545
* `media` : une chaîne de caractères. Restreint la feuille de styles à une [media query](https://developer.mozilla.org/fr/docs/Web/CSS/CSS_media_queries/Using_media_queries) spécifique.
4646
* `nonce` : une chaîne de caractères. Un [nonce cryptographique autorisant la ressource](https://developer.mozilla.org/fr/docs/Web/HTML/Global_attributes/nonce) dans le cadre d'une Politique de Sécurité de Contenu (CSP) stricte.

src/content/reference/react-dom/preconnect.md

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -5,13 +5,13 @@ canary: true
55

66
<Canary>
77

8-
The `preconnect` function is currently only available in React's Canary and experimental channels. Learn more about [React's release channels here](/community/versioning-policy#all-release-channels).
8+
La fonction `preconnect` n'est actuellement disponible que sur les canaux de livraison Canary et Expérimental de React. Apprenez-en davantage sur [les canaux de livraison React](/community/versioning-policy#all-release-channels).
99

1010
</Canary>
1111

1212
<Intro>
1313

14-
`preconnect` lets you eagerly connect to a server that you expect to load resources from.
14+
`preconnect` vous permet de vous connecter en avance à un serveur depuis lequel vous avez l'intention de charger des ressources.
1515

1616
```js
1717
preconnect("https://example.com");
@@ -23,11 +23,11 @@ preconnect("https://example.com");
2323

2424
---
2525

26-
## Reference {/*reference*/}
26+
## Référence {/*reference*/}
2727

2828
### `preconnect(href)` {/*preconnect*/}
2929

30-
To preconnect to a host, call the `preconnect` function from `react-dom`.
30+
Pour vous préconnecter à un hôte, appelez la fonction `preconnect` de `react-dom`.
3131

3232
```js
3333
import { preconnect } from 'react-dom';
@@ -39,34 +39,34 @@ function AppRoot() {
3939

4040
```
4141

42-
[See more examples below.](#usage)
42+
[Voir d'autres exemples plus bas](#usage).
4343

44-
The `preconnect` function provides the browser with a hint that it should open a connection to the given server. If the browser chooses to do so, this can speed up the loading of resources from that server.
44+
La fonction `preconnect` suggère au navigateur d'ouvrir une connection vers le serveur en question. Si le navigateur décide de le faire, ça accélèrera le chargement ultérieur de ressources depuis ce serveur.
4545

46-
#### Parameters {/*parameters*/}
46+
#### Paramètres {/*parameters*/}
4747

48-
* `href`: a string. The URL of the server you want to connect to.
48+
* `href` : une chaîne de caractères. L'URL du serveur auquel vous souhaitez vous connecter.
4949

5050

51-
#### Returns {/*returns*/}
51+
#### Valeur renvoyée {/*returns*/}
5252

53-
`preconnect` returns nothing.
53+
`preconnect` ne renvoie rien.
5454

55-
#### Caveats {/*caveats*/}
55+
#### Limitations {/*caveats*/}
5656

57-
* Multiple calls to `preconnect` with the same server have the same effect as a single call.
58-
* In the browser, you can call `preconnect` in any situation: while rendering a component, in an effect, in an event handler, and so on.
59-
* In server-side rendering or when rendering Server Components, `preconnect` only has an effect if you call it while rendering a component or in an async context originating from rendering a component. Any other calls will be ignored.
60-
* If you know the specific resources you'll need, you can call [other functions](/reference/react-dom/#resource-preloading-apis) instead that will start loading the resources right away.
61-
* There is no benefit to preconnecting to the same server the webpage itself is hosted from because it's already been connected to by the time the hint would be given.
57+
* Plusieurs appels à `preconnect` vers le même serveur ont le même effet qu'un unique appel.
58+
* Côté client, vous pouvez appeler `preconnect` n'importe où : lors du rendu d'un composant, dans un Effet, dans un gestionnaire d'événement, etc.
59+
* Lors d'un rendu côté serveur ou du rendu de Composants Serveur, `preconnect` n'a d'effet que si vous l'appelez lors du rendu d'un composant ou dans une fonction asynchrone issue du rendu d'un composant. Tout autre appel sera ignoré.
60+
* Si vous connaissez à l'avance les ressources précises dont vous aurez besoin, vous pouvez appeler [d'autres fonctions](/reference/react-dom/#resource-preloading-apis) plutôt que celle-ci, qui initieront directement le chargement des ressources.
61+
* Il n'y a aucun intérêt à se préconnecter au même serveur que celui qui sert la page web elle-même, car la connexion est déjà établie lorsque la suggestion est reçue.
6262

6363
---
6464

65-
## Usage {/*usage*/}
65+
## Utilisation {/*usage*/}
6666

67-
### Preconnecting when rendering {/*preconnecting-when-rendering*/}
67+
### Préconnexion lors du rendu {/*preconnecting-when-rendering*/}
6868

69-
Call `preconnect` when rendering a component if you know that its children will load external resources from that host.
69+
Appelez `preconnect` lors du rendu d'un composant si vous savez que ses enfants auront besoin de charger des ressources extérieures depuis un hôte donné.
7070

7171
```js
7272
import { preconnect } from 'react-dom';
@@ -77,9 +77,9 @@ function AppRoot() {
7777
}
7878
```
7979

80-
### Preconnecting in an event handler {/*preconnecting-in-an-event-handler*/}
80+
### Préconnexion dans un gestionnaire d'événement {/*preconnecting-in-an-event-handler*/}
8181

82-
Call `preconnect` in an event handler before transitioning to a page or state where external resources will be needed. This gets the process started earlier than if you call it during the rendering of the new page or state.
82+
Appelez `preconnect` depuis un gestionnaire d'événement avant de passer à une page ou un état qui auront besoin de ressources extérieures. Ça permet de déclencher le processus de connexion plus tôt que si vous l'appeliez au sein de la nouvelle page ou suite au nouvel état.
8383

8484
```js
8585
import { preconnect } from 'react-dom';
@@ -90,7 +90,7 @@ function CallToAction() {
9090
startWizard();
9191
}
9292
return (
93-
<button onClick={onClick}>Start Wizard</button>
93+
<button onClick={onClick}>Démarrer l’assistant</button>
9494
);
9595
}
9696
```

src/content/reference/react-dom/prefetchDNS.md

Lines changed: 23 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -5,13 +5,13 @@ canary: true
55

66
<Canary>
77

8-
The `prefetchDNS` function is currently only available in React's Canary and experimental channels. Learn more about [React's release channels here](/community/versioning-policy#all-release-channels).
8+
La fonction `prefetchDNS` n'est actuellement disponible que sur les canaux de livraison Canary et Expérimental de React. Apprenez-en davantage sur [les canaux de livraison React](/community/versioning-policy#all-release-channels).
99

1010
</Canary>
1111

1212
<Intro>
1313

14-
`prefetchDNS` lets you eagerly look up the IP of a server that you expect to load resources from.
14+
`prefetchDNS` vous permet de récupérer en avance l'IP d'un serveur depuis lequel vous avez l'intention de charger des ressources.
1515

1616
```js
1717
prefetchDNS("https://example.com");
@@ -23,11 +23,11 @@ prefetchDNS("https://example.com");
2323

2424
---
2525

26-
## Reference {/*reference*/}
26+
## Référence {/*reference*/}
2727

2828
### `prefetchDNS(href)` {/*prefetchdns*/}
2929

30-
To look up a host, call the `prefetchDNS` function from `react-dom`.
30+
Pour récupérer l'adresse IP d'un hôte, appelez la fonction `prefetchDNS` de `react-dom`.
3131

3232
```js
3333
import { prefetchDNS } from 'react-dom';
@@ -39,34 +39,34 @@ function AppRoot() {
3939

4040
```
4141

42-
[See more examples below.](#usage)
42+
[Voir d'autres exemples plus bas](#usage).
4343

44-
The prefetchDNS function provides the browser with a hint that it should look up the IP address of a given server. If the browser chooses to do so, this can speed up the loading of resources from that server.
44+
La fonction `prefetchDNS` suggère au navigateur de récupérer l'adresse IP du serveur en question. Si le navigateur décide de le faire, ça accélèrera le chargement ultérieur de ressources depuis ce serveur.
4545

46-
#### Parameters {/*parameters*/}
46+
#### Paramètres {/*parameters*/}
4747

48-
* `href`: a string. The URL of the server you want to connect to.
48+
* `href` : une chaîne de caractères. L'URL du serveur auquel vous souhaiterez vous connecter.
4949

50-
#### Returns {/*returns*/}
50+
#### Valeur renvoyée {/*returns*/}
5151

52-
`prefetchDNS` returns nothing.
52+
`prefetchDNS` ne renvoie rien.
5353

54-
#### Caveats {/*caveats*/}
54+
#### Limitations {/*caveats*/}
5555

56-
* Multiple calls to `prefetchDNS` with the same server have the same effect as a single call.
57-
* In the browser, you can call `prefetchDNS` in any situation: while rendering a component, in an effect, in an event handler, and so on.
58-
* In server-side rendering or when rendering Server Components, `prefetchDNS` only has an effect if you call it while rendering a component or in an async context originating from rendering a component. Any other calls will be ignored.
59-
* If you know the specific resources you'll need, you can call [other functions](/reference/react-dom/#resource-preloading-apis) instead that will start loading the resources right away.
60-
* There is no benefit to prefetching the same server the webpage itself is hosted from because it's already been looked up by the time the hint would be given.
61-
* Compared with [`preconnect`](/reference/react-dom/preconnect), `prefetchDNS` may be better if you are speculatively connecting to a large number of domains, in which case the overhead of preconnections might outweigh the benefit.
56+
* Plusieurs appels à `prefetchDNS` vers le même serveur ont le même effet qu'un unique appel.
57+
* Côté client, vous pouvez appeler `prefetchDNS` n'importe où : lors du rendu d'un composant, dans un Effet, dans un gestionnaire d'événement, etc.
58+
* Lors d'un rendu côté serveur ou du rendu de Composants Serveur, `prefetchDNS` n'a d'effet que si vous l'appelez lors du rendu d'un composant ou dans une fonction asynchrone issue du rendu d'un composant. Tout autre appel sera ignoré.
59+
* Si vous connaissez à l'avance les ressources précises dont vous aurez besoin, vous pouvez appeler [d'autres fonctions](/reference/react-dom/#resource-preloading-apis) plutôt que celle-ci, qui initieront directement le chargement des ressources.
60+
* Il n'y a aucun intérêt à récupérer l'IP du serveur qui sert la page web elle-même, car cette adresse est déjà connue lorsque la suggestion est reçue.
61+
* Comparée à [`preconnect`](/reference/react-dom/preconnect), `prefetchDNS` est peut-être plus intéressante si vous anticipez des connexions à une grande quantité de domaines, auquel cas des préconnexions effectives ont un coût relatif trop élevé.
6262

6363
---
6464

65-
## Usage {/*usage*/}
65+
## Utilisation {/*usage*/}
6666

67-
### Prefetching DNS when rendering {/*prefetching-dns-when-rendering*/}
67+
### Résolution DNS anticipée lors du rendu {/*prefetching-dns-when-rendering*/}
6868

69-
Call `prefetchDNS` when rendering a component if you know that its children will load external resources from that host.
69+
Appelez `prefetchDNS` lors du rendu d'un composant si vous savez que ses enfants auront besoin de charger des ressources extérieures depuis un hôte donné.
7070

7171
```js
7272
import { prefetchDNS } from 'react-dom';
@@ -77,9 +77,9 @@ function AppRoot() {
7777
}
7878
```
7979

80-
### Prefetching DNS in an event handler {/*prefetching-dns-in-an-event-handler*/}
80+
### Résolution DNS anticipée dans un gestionnaire d'événement {/*prefetching-dns-in-an-event-handler*/}
8181

82-
Call `prefetchDNS` in an event handler before transitioning to a page or state where external resources will be needed. This gets the process started earlier than if you call it during the rendering of the new page or state.
82+
Appelez `prefetchDNS` depuis un gestionnaire d'événement avant de passer à une page ou un état qui auront besoin de ressources extérieures. Ça permet de déclencher le processus de connexion plus tôt que si vous l'appeliez au sein de la nouvelle page ou suite au nouvel état.
8383

8484
```js
8585
import { prefetchDNS } from 'react-dom';
@@ -90,7 +90,7 @@ function CallToAction() {
9090
startWizard();
9191
}
9292
return (
93-
<button onClick={onClick}>Start Wizard</button>
93+
<button onClick={onClick}>Démarrer l’assistant</button>
9494
);
9595
}
9696
```

0 commit comments

Comments
 (0)