Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Sync with react.dev @ f55d9487 #638

Closed
wants to merge 5 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions src/content/reference/react-dom/components/link.md
Original file line number Diff line number Diff line change
Expand Up @@ -79,7 +79,11 @@ Ces props sont **déconseillées** pour une utilisation avec React :

#### Comportement spécifique de rendu {/*special-rendering-behavior*/}

<<<<<<< HEAD
React placera toujours l'élément DOM correspondant au composant `<link>` dans le `<head>` du document, peu importe où il figure dans l'arborescence React. Le `<head>` est le seul endroit valide pour un `<link>` dans le DOM, mais il est plus confortable, et préférable en termes de composition, qu'un composant représentant une page donnée puisse produire les composants `<link>` lui-même.
=======
React will always place the DOM element corresponding to the `<link>` component within the document’s `<head>`, regardless of where in the React tree it is rendered. The `<head>` is the only valid place for `<link>` to exist within the DOM, yet it’s convenient and keeps things composable if a component representing a specific page can render `<link>` components itself.
>>>>>>> f55d9487c6648570fc80f1421d7dca0a3b9b94b6

Il y a toutefois quelques exceptions :

Expand All @@ -91,8 +95,13 @@ Il y a toutefois quelques exceptions :

Qui plus est, si le `<link>` est une feuille de styles (en d'autres termes, ses props comportent `rel="stylesheet"`), React ajoutera le comportement spécifique que voici :

<<<<<<< HEAD
* Le composant qui utilise `<link>` [suspendra](/reference/react/Suspense) pendant le chargement de la feuille de styles.
* Si plusieurs composants produisent des liens vers la même feuille de styles, React les dédoublonnera et ne placera qu'un lien dans le DOM. Deux liens sont considérés identiques s'ils ont la même valeur de prop `href`.
=======
* The component that renders `<link>` will [suspend](/reference/react/Suspense) while the stylesheet is loading.
* If multiple components render links to the same stylesheet, React will de-duplicate them and only put a single link into the DOM. Two links are considered the same if they have the same `href` prop.
>>>>>>> f55d9487c6648570fc80f1421d7dca0a3b9b94b6

Ce comportement connaît toutefois deux exceptions :

Expand Down Expand Up @@ -133,7 +142,11 @@ export default function BlogPage() {

### Lier une feuille de styles {/*linking-to-a-stylesheet*/}

<<<<<<< HEAD
Si un composant dépend d'une certaine feuille de styles pour s'afficher correctement, vous pouvez produire un lien vers cette feuille de styles depuis le composant. Votre composant [suspendra](/reference/react/Suspense) le temps que la feuille de styles se charge. Vous pouvez fournir une prop `precedence` qui indiquera à React où injecter la feuille par rapport aux autres — les feuilles de styles avec une précédence plus forte pourront surcharger celles avec une précédence plus faible.
=======
If a component depends on a certain stylesheet in order to be displayed correctly, you can render a link to that stylesheet within the component. Your component will [suspend](/reference/react/Suspense) while the stylesheet is loading. You must supply the `precedence` prop, which tells React where to place this stylesheet relative to others — stylesheets with higher precedence can override those with lower precedence.
>>>>>>> f55d9487c6648570fc80f1421d7dca0a3b9b94b6

<Note>

Expand Down Expand Up @@ -219,7 +232,11 @@ function Component() {

### Annoter des éléments spécifiques du document avec des liens {/*annotating-specific-items-within-the-document-with-links*/}

<<<<<<< HEAD
Vous pouvez utiliser le composant `<link>` avec la prop `itemProp` pour annoter des éléments spécifiques du document avec des liens vers des ressources associées. Dans ce cas, React, n'injectera *pas* ces annotations dans le `<head>` du document, mais les placera comme n'importe quel autre composant React.
=======
You can use the `<link>` component with the `itemProp` prop to annotate specific items within the document with links to related resources. In this case, React will *not* place these annotations within the document `<head>` but will place them like any other React component.
>>>>>>> f55d9487c6648570fc80f1421d7dca0a3b9b94b6

```js
<section itemScope>
Expand Down
4 changes: 4 additions & 0 deletions src/content/reference/react-dom/components/style.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,11 @@ Ces props sont **déconseillées** pour une utilisation avec React :

#### Comportement spécifique de rendu {/*special-rendering-behavior*/}

<<<<<<< HEAD
React peut déplacer les composants `<style>` dans le `<head>` du document, dédoublonner les feuilles de styles identiques et [suspendre](/reference/react/Suspense) pendant le chargement de la feuille de styles.
=======
React can move `<style>` components to the document's `<head>`, de-duplicate identical stylesheets, and [suspend](/reference/react/Suspense) while the stylesheet is loading.
>>>>>>> f55d9487c6648570fc80f1421d7dca0a3b9b94b6

Pour activer ces comportements, fournissez les props `href` et `precedence`. React dédoublonnera les feuilles de styles qui ont le même `href`. La précédence indique à React où placer le nœud DOM `<style>` par rapport aux autres dans le `<head>` du document, ce qui détermine quelle feuille de styles peut surcharger quelle autre.

Expand Down
12 changes: 12 additions & 0 deletions src/content/reference/react/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,18 @@ React-DOM comprend les fonctionnalités qui ne sont prises en charge que pour le
* [Fonctions côté client](/reference/react-dom/client) - L'API dans `react-dom/client` vous permet d'effectuer le rendu de composants React côté client (dans le navigateur).
* [Fonctions côté serveur](/reference/react-dom/server) - L'API dans `react-dom/server` vous permet d'effectuer le rendu de composants React côté serveur, vers du HTML.

<<<<<<< HEAD
## API React historique {/*legacy-apis*/}
=======
## Rules of React {/*rules-of-react*/}

React has idioms — or rules — for how to express patterns in a way that is easy to understand and yields high-quality applications:

* [Components and Hooks must be pure](/reference/rules/components-and-hooks-must-be-pure) – Purity makes your code easier to understand, debug, and allows React to automatically optimize your components and hooks correctly.
* [React calls Components and Hooks](/reference/rules/react-calls-components-and-hooks) – React is responsible for rendering components and hooks when necessary to optimize the user experience.
* [Rules of Hooks](/reference/rules/rules-of-hooks) – Hooks are defined using JavaScript functions, but they represent a special type of reusable UI logic with restrictions on where they can be called.

## Legacy APIs {/*legacy-apis*/}
>>>>>>> f55d9487c6648570fc80f1421d7dca0a3b9b94b6

* [API React historique](/reference/react/legacy) - Ces fonctions sont présentes dans le module `react`, mais leur utilisation est découragée pour tout nouveau code.
Loading
Loading