diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index 4b3bbb6e6..66b3ca729 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -1,6 +1,6 @@ --- id: components-and-props -title: Components and Props +title: Composants et Props permalink: docs/components-and-props.html redirect_from: - "docs/reusable-components.html" @@ -16,57 +16,57 @@ prev: rendering-elements.html next: state-and-lifecycle.html --- -Components let you split the UI into independent, reusable pieces, and think about each piece in isolation. This page provides an introduction to the idea of components. You can find a [detailed component API reference here](/docs/react-component.html). +Les composants vous permettent de découper l’interface utilisateur en éléments indépendants et réutilisables, vous permettant ainsi de considérer chaque élément de manière isolée. Cette page fournit une introduction au concept de composants. Vous trouverez une [référence détaillée de l’API des composants ici](/docs/react-component.html). -Conceptually, components are like JavaScript functions. They accept arbitrary inputs (called "props") and return React elements describing what should appear on the screen. +Conceptuellement, les composants sont comme des fonctions JavaScript. Ils acceptent des entrées quelconques (appelées « props ») et renvoient des éléments React décrivant ce qui doit apparaître à l’écran. -## Function and Class Components {#function-and-class-components} +## Fonctions Composants et Composants à Base de Classes {#function-and-class-components} -The simplest way to define a component is to write a JavaScript function: +Le moyen le plus simple de définir un composant consiste à écrire une fonction JavaScript : ```js function Welcome(props) { - return

Hello, {props.name}

; + return

Bonjour, {props.name}

; } ``` -This function is a valid React component because it accepts a single "props" (which stands for properties) object argument with data and returns a React element. We call such components "function components" because they are literally JavaScript functions. +Cette fonction est un composant React valide car elle accepte un seul argument « props » (qui signifie « propriétés ») contenant des données, et renvoie un élément React. Nous appelons de tels composants des « fonctions composants », car ce sont littéralement des fonctions JavaScript. -You can also use an [ES6 class](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Classes) to define a component: +Vous pouvez également utiliser une [classe ES6](https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Classes) pour définir un composant : ```js class Welcome extends React.Component { render() { - return

Hello, {this.props.name}

; + return

Bonjour, {this.props.name}

; } } ``` -The above two components are equivalent from React's point of view. +Les deux composants ci-dessus sont équivalents du point de vue de React. -Classes have some additional features that we will discuss in the [next sections](/docs/state-and-lifecycle.html). Until then, we will use function components for their conciseness. +Les classes possèdent quelques fonctionnalités supplémentaires dont nous discuterons dans les [prochaines sections](/docs/state-and-lifecycle.html). En attendant, nous utiliserons les fonctions composants pour leur concision. -## Rendering a Component {#rendering-a-component} +## Produire le rendu d’un Component {#rendering-a-component} -Previously, we only encountered React elements that represent DOM tags: +Jusqu’ici, nous n’avons rencontré que des éléments React représentant des balises DOM : ```js const element =
; ``` -However, elements can also represent user-defined components: +Mais ces éléments peuvent également représenter des composants définis par l’utilisateur : ```js const element = ; ``` -When React sees an element representing a user-defined component, it passes JSX attributes to this component as a single object. We call this object "props". +Lorsque React rencontre un élément représentant un composant défini par l’utilisateur, il transmet les attributs JSX à ce composant sous la forme d’un objet unique. Nous appelons cet objet « props ». -For example, this code renders "Hello, Sara" on the page: +Par exemple, ce code affiche « Bonjour, Sara » sur la page : ```js{1,5} function Welcome(props) { - return

Hello, {props.name}

; + return

Bonjour, {props.name}

; } const element = ; @@ -76,30 +76,30 @@ ReactDOM.render( ); ``` -[](codepen://components-and-props/rendering-a-component) +**[Essayer sur CodePen](codepen://components-and-props/rendering-a-component)** -Let's recap what happens in this example: +Récapitulons ce qui se passe dans cet exemple : -1. We call `ReactDOM.render()` with the `` element. -2. React calls the `Welcome` component with `{name: 'Sara'}` as the props. -3. Our `Welcome` component returns a `

Hello, Sara

` element as the result. -4. React DOM efficiently updates the DOM to match `

Hello, Sara

`. +1. On appelle `ReactDOM.render()` avec l’élément ``. +2. React appelle le composant `Welcome` avec comme props `{name: 'Sara'}`. +3. Notre composant `Welcome` retourne un élément `

Bonjour, Sara

` pour résultat. +4. React DOM met à jour efficacement le DOM pour correspondre à `

Bonjour, Sara

`. ->**Note:** Always start component names with a capital letter. +>**Remarque :** commencez toujours vos noms de composants par une majuscule. > ->React treats components starting with lowercase letters as DOM tags. For example, `
` represents an HTML div tag, but `` represents a component and requires `Welcome` to be in scope. +>React considère les composants commençant par des lettres minuscules comme des balises DOM. Par exemple, `
` représente une balise HTML div, mais `` représente un composant, et exige que l’identifiant `Welcome` existe dans la portée courante. > ->To learn more about the reasoning behind this convention, please read [JSX In Depth](/docs/jsx-in-depth.html#user-defined-components-must-be-capitalized). +>Pour en en apprendre davantage sur le raisonnement qui sous-tend cette convention, lisez donc [JSX en Profondeur](/docs/jsx-in-depth.html#user-defined-components-must-be-capitalized). -## Composing Components {#composing-components} +## Composition de Composants {#composing-components} -Components can refer to other components in their output. This lets us use the same component abstraction for any level of detail. A button, a form, a dialog, a screen: in React apps, all those are commonly expressed as components. +Les composants peuvent faire référence à d’autres composants dans leur sortie. Ça nous permet d’utiliser la même abstraction de composants pour n’importe quel niveau de détail. Un bouton, un formulaire, une boîte de dialogue, un écran : dans React, ils sont généralement tous exprimés par des composants. -For example, we can create an `App` component that renders `Welcome` many times: +Par exemple, nous pouvons créer un composant `App` qui utilise plusieurs fois ` Welcome` : ```js{8-10} function Welcome(props) { - return

Hello, {props.name}

; + return

Bonjour, {props.name}

; } function App() { @@ -118,15 +118,15 @@ ReactDOM.render( ); ``` -[](codepen://components-and-props/composing-components) +**[Essayer sur CodePen](codepen://components-and-props/composing-components)** -Typically, new React apps have a single `App` component at the very top. However, if you integrate React into an existing app, you might start bottom-up with a small component like `Button` and gradually work your way to the top of the view hierarchy. +En règle générale, les nouvelles applications React ont un seul composant `App` à la racine. En revanche, si vous intégrez React à une application existante, vous pouvez commencer tout en bas par un petit composant comme `Button` et remonter progressivement la hiérarchie des vues. -## Extracting Components {#extracting-components} +## Extraire des Composants {#extracting-components} -Don't be afraid to split components into smaller components. +N’ayez pas peur de scinder des composants en composants plus petits. -For example, consider this `Comment` component: +Prenons par exemple ce composant `Comment` : ```js function Comment(props) { @@ -152,13 +152,13 @@ function Comment(props) { } ``` -[](codepen://components-and-props/extracting-components) +**[Essayer sur CodePen](codepen://components-and-props/extracting-components)** -It accepts `author` (an object), `text` (a string), and `date` (a date) as props, and describes a comment on a social media website. +Il accepte comme props `author` (un objet), `text` (une chaîne de caractères) et `date` (une date), et décrit un commentaire sur un réseau social en ligne. -This component can be tricky to change because of all the nesting, and it is also hard to reuse individual parts of it. Let's extract a few components from it. +Les nombreuses imbrications au sein du composant le rendent difficile à maintenir, et nous empêchent d’en réutiliser des parties individuelles. Essayons donc d'en extraire quelques composants. -First, we will extract `Avatar`: +Pour commencer, nous allons extraire `Avatar` : ```js{3-6} function Avatar(props) { @@ -171,11 +171,11 @@ function Avatar(props) { } ``` -The `Avatar` doesn't need to know that it is being rendered inside a `Comment`. This is why we have given its prop a more generic name: `user` rather than `author`. +Le composant `Avatar` n’a pas besoin de savoir qu’il figure dans un composant `Comment`. C’est pourquoi nous avons donné à sa prop un nom plus générique : `user` plutôt que `author`. -We recommend naming props from the component's own point of view rather than the context in which it is being used. +Nous vous recommandons de nommer les props du point de vue du composant plutôt que de celui du contexte dans lequel il est utilisé. -We can now simplify `Comment` a tiny bit: +On peut maintenant simplifier un poil`Comment`  : ```js{5} function Comment(props) { @@ -198,7 +198,7 @@ function Comment(props) { } ``` -Next, we will extract a `UserInfo` component that renders an `Avatar` next to the user's name: +Ensuite, nous allons extraire un composant `UserInfo` qui affiche un `Avatar` à côté du nom de l’utilisateur : ```js{3-8} function UserInfo(props) { @@ -213,7 +213,7 @@ function UserInfo(props) { } ``` -This lets us simplify `Comment` even further: +Ce qui nous permet de simplifier encore davantage `Comment` : ```js{4} function Comment(props) { @@ -231,23 +231,23 @@ function Comment(props) { } ``` -[](codepen://components-and-props/extracting-components-continued) +**[Essayer sur CodePen](codepen://components-and-props/extracting-components-continued)** -Extracting components might seem like grunt work at first, but having a palette of reusable components pays off in larger apps. A good rule of thumb is that if a part of your UI is used several times (`Button`, `Panel`, `Avatar`), or is complex enough on its own (`App`, `FeedStory`, `Comment`), it is a good candidate to be a reusable component. +Au début, extraire des composants peut vous sembler fastidieux, mais disposer d’une palette de composants réutilisables s’avère rentable sur des applications de plus grande taille. En règle générale, si une partie de votre interface utilisateur est utilisée plusieurs fois (`Button`, `Panel`, `Avatar`) ou si elle est suffisamment complexe en elle-même (`App`, `FeedStory`, `Comment`), c’est un bon candidat pour un composant réutilisable. -## Props are Read-Only {#props-are-read-only} - -Whether you declare a component [as a function or a class](#function-and-class-components), it must never modify its own props. Consider this `sum` function: +## Les Props Sont en Lecture Seule {#props-are-read-only} +Que vous déclariez un composant [sous forme de fonction ou de classe](#function-and-class-components), il ne doit jamais modifier ses propres props. Considérons cette fonction `sum` : +  ```js function sum(a, b) { return a + b; } ``` -Such functions are called ["pure"](https://en.wikipedia.org/wiki/Pure_function) because they do not attempt to change their inputs, and always return the same result for the same inputs. +Ces fonctions sont dites [« pures »](https://fr.wikipedia.org/wiki/Fonction_pure) parce qu’elles ne tentent pas de modifier leurs entrées et retournent toujours le même résultat pour les mêmes entrées. -In contrast, this function is impure because it changes its own input: +En revanche, cette fonction est impure car elle modifie sa propre entrée : ```js function withdraw(account, amount) { @@ -255,8 +255,8 @@ function withdraw(account, amount) { } ``` -React is pretty flexible but it has a single strict rule: +React est plutôt flexible mais applique une règle stricte : -**All React components must act like pure functions with respect to their props.** +**Tout composant React doit agir comme une fonction pure vis-à-vis de ses props.** -Of course, application UIs are dynamic and change over time. In the [next section](/docs/state-and-lifecycle.html), we will introduce a new concept of "state". State allows React components to change their output over time in response to user actions, network responses, and anything else, without violating this rule. +Bien entendu, les interfaces utilisateurs des applications sont dynamiques et évoluent dans le temps. Dans la [prochaine section](/docs/state-and-lifecycle.html), nous présenterons un nouveau concept « d’état local ». L’état local permet aux composants React de modifier leur sortie au fil du temps en fonction des actions de l’utilisateur, des réponses réseau et de n’importe quoi d’autre, mais sans enfreindre cette règle.