Skip to content

Commit 0668721

Browse files
committed
copy(l10n): first part of React rules
1 parent 934ff0a commit 0668721

File tree

3 files changed

+26
-24
lines changed

3 files changed

+26
-24
lines changed

src/content/reference/rules/components-and-hooks-must-be-pure.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Les composants et les Hooks doivent être purs
2+
title: Les composants et les Hooks doivent être des fonctions pures
33
---
44

55
{/* FIXME:L10N */}

src/content/reference/rules/index.md

Lines changed: 24 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -2,53 +2,55 @@
22
title: Les règles de React
33
---
44

5-
{/* FIXME:L10N */}
6-
75
<Intro>
8-
Just as different programming languages have their own ways of expressing concepts, React has its own idioms — or rules — for how to express patterns in a way that is easy to understand and yields high-quality applications.
6+
7+
Tout comme des langages de programmation distincts ont leurs propres manières d'exprimer des concepts, React a ses propres idiômes — ou règles — pour exprimer certaines approches de façon facile à comprendre, afin de produire des applications de grande qualité.
8+
99
</Intro>
1010

1111
<InlineToc />
1212

1313
---
1414

1515
<Note>
16-
To learn more about expressing UIs with React, we recommend reading [Thinking in React](/learn/thinking-in-react).
16+
17+
Pour apprendre comment décrire des UI avec React, nous vous recommandons de lire [Penser en React](/learn/thinking-in-react).
18+
1719
</Note>
1820

19-
This section describes the rules you need to follow to write idiomatic React code. Writing idiomatic React code can help you write well organized, safe, and composable applications. These properties make your app more resilient to changes and makes it easier to work with other developers, libraries, and tools.
21+
Cette section décrit les règles que vous devez suivre pour écrire du code React idiomatique. Écrire du code React idiomatique vous aidera à construire des applications bien organisées, fiables et composables. Ces propriétés améliorent la résilience aux chaangements de votre appli, et facilitent son sa maintenance par d'autres développeur·ses et son intégration avec des bibliothèques et outils tiers.
2022

21-
These rules are known as the **Rules of React**. They are rules – and not just guidelines – in the sense that if they are broken, your app likely has bugs. Your code also becomes unidiomatic and harder to understand and reason about.
23+
Ces règles sont connues sous le termes **Règles de React**. Ce sont bien des règles — et pas juste des recommandations — dans le sens où, si vous les enfreignez, votre appli aura sans doute des bugs. Votre code deviendra non-idiomatique et plus difficile à comprendre et à modéliser mentalement.
2224

23-
We strongly recommend using [Strict Mode](/reference/react/StrictMode) alongside React's [ESLint plugin](https://www.npmjs.com/package/eslint-plugin-react-hooks) to help your codebase follow the Rules of React. By following the Rules of React, you'll be able to find and address these bugs and keep your application maintainable.
25+
Nous vous encourageons fortement à utiliser le [mode strict](/reference/react/StrictMode) ainsi que le [plugin ESLint](https://www.npmjs.com/package/eslint-plugin-react-hooks) de React pour vous aider à produire une base de code qui suive les Règles de React. En suivant les Règles de React, vous détecterez et corrigerez ces bugs et obtiendrez une application plus maintenable.
2426

2527
---
2628

27-
## Components and Hooks must be pure {/*components-and-hooks-must-be-pure*/}
29+
## Les composants et les Hooks doivent être des fonctions pures {/*components-and-hooks-must-be-pure*/}
2830

29-
[Purity in Components and Hooks](/reference/rules/components-and-hooks-must-be-pure) is a key rule of React that makes your app predictable, easy to debug, and allows React to automatically optimize your code.
31+
[La pureté des Composants et des Hooks](/reference/rules/components-and-hooks-must-be-pure) est une règle clé de React qui rend votre appli prévisible, facile à déboguer, et permet à React d'optimiser votre code.
3032

31-
* [Components must be idempotent](/reference/rules/components-and-hooks-must-be-pure#components-and-hooks-must-be-idempotent)React components are assumed to always return the same output with respect to their inputs – props, state, and context.
32-
* [Side effects must run outside of render](/reference/rules/components-and-hooks-must-be-pure#side-effects-must-run-outside-of-render)Side effects should not run in render, as React can render components multiple times to create the best possible user experience.
33-
* [Props and state are immutable](/reference/rules/components-and-hooks-must-be-pure#props-and-state-are-immutable)A component’s props and state are immutable snapshots with respect to a single render. Never mutate them directly.
34-
* [Return values and arguments to Hooks are immutable](/reference/rules/components-and-hooks-must-be-pure#return-values-and-arguments-to-hooks-are-immutable)Once values are passed to a Hook, you should not modify them. Like props in JSX, values become immutable when passed to a Hook.
35-
* [Values are immutable after being passed to JSX](/reference/rules/components-and-hooks-must-be-pure#values-are-immutable-after-being-passed-to-jsx)Don’t mutate values after they’ve been used in JSX. Move the mutation before the JSX is created.
33+
* [Les composants doivent être idempotents](/reference/rules/components-and-hooks-must-be-pure#components-and-hooks-must-be-idempotent)Les composants React sont supposés toujours renvoyer le même résultat pour les mêmes entrées – props, états locaux et contextes.
34+
* [Les effets de bord doivent être exécutés hors du rendu](/reference/rules/components-and-hooks-must-be-pure#side-effects-must-run-outside-of-render)Les effets de bord ne doivent pas être exécutés lors du rendu, afin que React puisse effectuer plusieurs fois le rendu de composants afin de créer la meilleure expérience utilisateur.
35+
* [Les props et l'état sont immuables](/reference/rules/components-and-hooks-must-be-pure#props-and-state-are-immutable)Les props et les états locaux d'un composant sont considérés comme des instantanés immuables au sein d'un même rendu. Ne les modifiez jamais directement.
36+
* [Les valeurs renvoyées par les Hooks et leurs arguments sont immuables](/reference/rules/components-and-hooks-must-be-pure#return-values-and-arguments-to-hooks-are-immutable)Une fois que des valeurs sont passées à un Hook, vous ne devriez jamais les modifier. Tout comme les props en JSX, ces valeurs deviennent immuables une fois passées à un Hook.
37+
* [Les valeurs sont immuables une fois passées à JSX](/reference/rules/components-and-hooks-must-be-pure#values-are-immutable-after-being-passed-to-jsx)Ne modifiez pas des valeurs une fois que vous les avez utilisées dans du JSX. Déplacez la mutation en amont, avant que le JSX soit créé.
3638

3739
---
3840

39-
## React calls Components and Hooks {/*react-calls-components-and-hooks*/}
41+
## React appelle les composants et les Hooks {/*react-calls-components-and-hooks*/}
4042

41-
[React is responsible for rendering components and hooks when necessary to optimize the user experience.](/reference/rules/react-calls-components-and-hooks) It is declarative: you tell React what to render in your component’s logic, and React will figure out how best to display it to your user.
43+
[React s'occupe de réaliser le rendu des composants et des Hooks lorsque c'est nécessaire, afin d'optimiser l'expérience utilisateur](/reference/rules/react-calls-components-and-hooks). C'est une approche déclarative : vous dites à React quel rendu effectuer dans la logique de votre composant, et React déterminera comment réaliser au mieux l'affichage pour l'utilisateur.
4244

43-
* [Never call component functions directly](/reference/rules/react-calls-components-and-hooks#never-call-component-functions-directly)Components should only be used in JSX. Don’t call them as regular functions.
44-
* [Never pass around hooks as regular values](/reference/rules/react-calls-components-and-hooks#never-pass-around-hooks-as-regular-values) – Hooks should only be called inside of components. Never pass it around as a regular value.
45+
* [N'appelez jamais les fonctions composants directement](/reference/rules/react-calls-components-and-hooks#never-call-component-functions-directly)Les composants ne devraient être utilisés que dans du JSX. Ne les appelez pas en tant que fonctions classiques.
46+
* [Ne passez jamais des Hooks comme des valeurs classiques](/reference/rules/react-calls-components-and-hooks#never-pass-around-hooks-as-regular-values)Les Hooks ne devraient être appelés qu'au sein de composants. Ne les passez pas comme des valeurs classiques.
4547

4648
---
4749

48-
## Rules of Hooks {/*rules-of-hooks*/}
50+
## Les règles des Hooks {/*rules-of-hooks*/}
4951

50-
Hooks are defined using JavaScript functions, but they represent a special type of reusable UI logic with restrictions on where they can be called. You need to follow the [Rules of Hooks](/reference/rules/rules-of-hooks) when using them.
52+
Les Hooks sont définis au moyen de fonctions JavaScript, mais représentent un type spécifique de logique d'UI réutilisable, avec des restrictions sur leurs emplacements d'appel. Vous devez suivre les [Règles des Hooks](/reference/rules/rules-of-hooks) lorsque vous les employez.
5153

52-
* [Only call Hooks at the top level](/reference/rules/rules-of-hooks#only-call-hooks-at-the-top-level)Don’t call Hooks inside loops, conditions, or nested functions. Instead, always use Hooks at the top level of your React function, before any early returns.
53-
* [Only call Hooks from React functions](/reference/rules/rules-of-hooks#only-call-hooks-from-react-functions)Don’t call Hooks from regular JavaScript functions.
54+
* [N'appelez des Hooks qu'au niveau racine](/reference/rules/rules-of-hooks#only-call-hooks-at-the-top-level)Ne les appelez pas dans des boucles, des conditions ou des fonctions imbriquées. Utilisez plutôt toujours les Hooks au niveau racine de votre fonction React, avant d'éventuels retours anticipés.
55+
* [N'appelez les Hooks que depuis des fonctions React](/reference/rules/rules-of-hooks#only-call-hooks-from-react-functions)N'appelez pas les Hooks depuis des fonctions JavaScript classiques.
5456

src/sidebarReference.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -346,7 +346,7 @@
346346
"path": "/reference/rules",
347347
"routes": [
348348
{
349-
"title": "Les composants et les Hooks doivent être purs",
349+
"title": "Les composants et les Hooks doivent être des fonctions pures",
350350
"path": "/reference/rules/components-and-hooks-must-be-pure"
351351
},
352352
{

0 commit comments

Comments
 (0)