From 54ca4947ffcfc2b182d3d7f5cb61789cc2ddb999 Mon Sep 17 00:00:00 2001 From: linsolas Date: Sun, 11 Jun 2023 19:01:45 +0200 Subject: [PATCH 1/7] first translation of Extracting State Logic into a Reducer --- .../extracting-state-logic-into-a-reducer.md | 439 +++++++++--------- 1 file changed, 218 insertions(+), 221 deletions(-) diff --git a/src/content/learn/extracting-state-logic-into-a-reducer.md b/src/content/learn/extracting-state-logic-into-a-reducer.md index 012a5c3f9..29a312b89 100644 --- a/src/content/learn/extracting-state-logic-into-a-reducer.md +++ b/src/content/learn/extracting-state-logic-into-a-reducer.md @@ -1,25 +1,25 @@ --- -title: Extracting State Logic into a Reducer +title: Extraire la logique d'état dans un réducteur --- -Components with many state updates spread across many event handlers can get overwhelming. For these cases, you can consolidate all the state update logic outside your component in a single function, called a _reducer._ +Les composants comportant beaucoup mises à jour d'état réparties à traver de nombreux gestionnaires d'événements peuvent devenir encombrants. Dans ces circonstances, vous pouvez consolider toute la logique de mise à jour de l'état dans une seule fonction, appelée _réducteur_. -- What a reducer function is -- How to refactor `useState` to `useReducer` -- When to use a reducer -- How to write one well +- Ce qu'est une fonction de réducteur +- Comment remplacer `useState` avec `useReducer` +- Quand utiliser un réducteur +- Comment l'écrire correctement -## Consolidate state logic with a reducer {/*consolidate-state-logic-with-a-reducer*/} +## Consolider la logique d'état avec un réducteur {/*consolidate-state-logic-with-a-reducer*/} -As your components grow in complexity, it can get harder to see at a glance all the different ways in which a component's state gets updated. For example, the `TaskApp` component below holds an array of `tasks` in state and uses three different event handlers to add, remove, and edit tasks: +Au fur et mesure que vos composants gagnent en complexité, il devient difficile de voir d'un coup d'œil les différentes façons dont l'état d'un composant est mis à jour. Par exemple, le composant `TaskApp` ci-dessous contient un tableau de `tasks` dans un état et utilise trois gestionnaires d'événements différents pour créer, supprimer ou éditer des tâches : @@ -60,7 +60,7 @@ export default function TaskApp() { return ( <> -

Prague itinerary

+

Voyage à Prague

setText(e.target.value)} /> @@ -133,14 +133,14 @@ function Task({task, onChange, onDelete}) { }); }} /> - + ); } else { taskContent = ( <> {task.text} - + ); } @@ -157,7 +157,7 @@ function Task({task, onChange, onDelete}) { }} /> {taskContent} - + ); } @@ -179,17 +179,17 @@ li {
-Each of its event handlers calls `setTasks` in order to update the state. As this component grows, so does the amount of state logic sprinkled throughout it. To reduce this complexity and keep all your logic in one easy-to-access place, you can move that state logic into a single function outside your component, **called a "reducer".** +Chaque gestionnaire d'événement appelle `setTasks` afin de mettre à jour l'état. Avec l'évolution de ce composant, la quantité de logique qui l'entoure grandit également. Pour réduire cette complexité et garder votre logique en un seul endroit facile d'accès, vous pouvez déplacer cette logique d'état dans une seule fonction **appelée « réducteur »** à l'extérieur du composant. -Reducers are a different way to handle state. You can migrate from `useState` to `useReducer` in three steps: +Les réducteurs sont une autre façon de gérer l'état. Vous pouvez migrer de `useState` à `useReducer` en trois étapes : -1. **Move** from setting state to dispatching actions. -2. **Write** a reducer function. -3. **Use** the reducer from your component. +1. **Passez** de la définition d'état aux actions de *dispatch*. +2. **Écrivez** une fonction de réduction. +3. **Utilisez** le réducteur depuis votre composant. -### Step 1: Move from setting state to dispatching actions {/*step-1-move-from-setting-state-to-dispatching-actions*/} +### Étape 1 : passez de la définition d'état aux actions de *dispatch* {/*step-1-move-from-setting-state-to-dispatching-actions*/} -Your event handlers currently specify _what to do_ by setting state: +Vos gestionnaires d'événements spécifient pour le moment _ce qu'il faut faire_ en définissant l'état : ```js function handleAddTask(text) { @@ -220,13 +220,13 @@ function handleDeleteTask(taskId) { } ``` -Remove all the state setting logic. What you are left with are three event handlers: +Supprimez toute la logique de définition d'état. Il vous reste ces trois gestionnaires d'événements : -- `handleAddTask(text)` is called when the user presses "Add". -- `handleChangeTask(task)` is called when the user toggles a task or presses "Save". -- `handleDeleteTask(taskId)` is called when the user presses "Delete". +- `handleAddTask(text)` est appelé quand l'utilisateur appuie sur « Ajouter ». +- `handleChangeTask(task)` est appelé quand l'utilisateur change de tâche ou appuie sur « Enregistrer ». +- `handleDeleteTask(taskId)` est appelé quand l'utilisateur appuie sur « Supprimer ». -Managing state with reducers is slightly different from directly setting state. Instead of telling React "what to do" by setting state, you specify "what the user just did" by dispatching "actions" from your event handlers. (The state update logic will live elsewhere!) So instead of "setting `tasks`" via an event handler, you're dispatching an "added/changed/deleted a task" action. This is more descriptive of the user's intent. +La gestion de l'état avec des réducteurs est légèrement différente que lorsque l'état est définit directement. Plutôt que de dire à React « quoi faire » en définissant l'état, vous spécifiez « ce que l'utilisateur vient de faire » en émettant des « actions » à partir de vos gestionnaires d'événements (la logique de mise à jour de l'état se situe ailleurs). Ainsi, au lieu de « définir `tasks` » *via* un gestionnaire d'événement, vous émettez une action « ajout / mis à jour / suppression d'une tâche ». Ça décrit mieux l'intention de l'utilisateur. ```js function handleAddTask(text) { @@ -252,12 +252,12 @@ function handleDeleteTask(taskId) { } ``` -The object you pass to `dispatch` is called an "action": +L'object que vous passez à `dispatch` est appelé une « action » : ```js {3-7} function handleDeleteTask(taskId) { dispatch( - // "action" object: + // objet « action » : { type: 'deleted', id: taskId, @@ -266,43 +266,43 @@ function handleDeleteTask(taskId) { } ``` -It is a regular JavaScript object. You decide what to put in it, but generally it should contain the minimal information about _what happened_. (You will add the `dispatch` function itself in a later step.) +C'est un objet JavaScript ordinaire. Vous décidez ce que vous y mettez, mais généralement il doit contenir just les informations sur _ce qui vient d'arriver_ (you ajouterez la fonction `dispatch` vous-même dans une prochaine étape). -An action object can have any shape. +Un objet action peut avoir n'importe quelle forme. -By convention, it is common to give it a string `type` that describes what happened, and pass any additional information in other fields. The `type` is specific to a component, so in this example either `'added'` or `'added_task'` would be fine. Choose a name that says what happened! +Par convention, il est courant d'attribuer une chaine de caractères `type` qui décrit ce qui s'est passé, et d'ajouter les informations complémentaires dans d'autres champs. Le `type` est spécifique à un composant, donc dans cet exemple, `'added'` ou `'added_task'` conviendrait. Choisissez un nom qui explique ce qui s'est passé ! ```js dispatch({ - // specific to component + // Spécifique au composant type: 'what_happened', - // other fields go here + // Les autres champs vont ici }); ``` -### Step 2: Write a reducer function {/*step-2-write-a-reducer-function*/} +### Étape 2 : écrivez une fonction de réduction {/*step-2-write-a-reducer-function*/} -A reducer function is where you will put your state logic. It takes two arguments, the current state and the action object, and it returns the next state: +Votre logique d'état se situera dans une fonction de réduction. Elle prend deux arguments, l'état courant et l'objet d'action, puis renvoie le nouvel état : ```js function yourReducer(state, action) { - // return next state for React to set + // renvoie le prochain état à définir par React } ``` -React will set the state to what you return from the reducer. +React va définir l'état avec ce que renvoie le réducteur. -To move your state setting logic from your event handlers to a reducer function in this example, you will: +Pour déplacer votre logique de définition d'état des gestionnaires d'événements à une fonction de réduction, vous ferez dans cet exemple : -1. Declare the current state (`tasks`) as the first argument. -2. Declare the `action` object as the second argument. -3. Return the _next_ state from the reducer (which React will set the state to). +1. Déclarez l'état courant (`tasks`) comme premier argument. +2. Déclarez l'objet `action` comme second argument. +3. Renvoyez le _prochain_ état depuis le réducteur (à partir duquel React fixera l'état). -Here is all the state setting logic migrated to a reducer function: +Voici toute la logique de définition d'état une fois migrée vers une fonction de réduction : ```js function tasksReducer(tasks, action) { @@ -326,18 +326,18 @@ function tasksReducer(tasks, action) { } else if (action.type === 'deleted') { return tasks.filter((t) => t.id !== action.id); } else { - throw Error('Unknown action: ' + action.type); + throw Error('Action inconnue : ' + action.type); } } ``` -Because the reducer function takes state (`tasks`) as an argument, you can **declare it outside of your component.** This decreases the indentation level and can make your code easier to read. +Puisque la fonction de réduction prend l'état (`tasks`) comme argument, vous pouvez **le déclarer en dehors de votre composant**. Ça réduit ainsi le niveau d'indentation et rend votre code plus facile à lire. -The code above uses if/else statements, but it's a convention to use [switch statements](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/switch) inside reducers. The result is the same, but it can be easier to read switch statements at a glance. +Le code plus haut utilise des instructions `if` / `else`, mais on utilisera [l'instruction `switch`](https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Statements/switch) au sein des réducteurs. Le résultat est le même, mais il peut être plus facile de lire des instructions `switch` d'un coup d'œil. -We'll be using them throughout the rest of this documentation like so: +Nous les utiliserons dans le reste de cette documentation de cette façon : ```js function tasksReducer(tasks, action) { @@ -365,25 +365,25 @@ function tasksReducer(tasks, action) { return tasks.filter((t) => t.id !== action.id); } default: { - throw Error('Unknown action: ' + action.type); + throw Error('Action inconnue : ' + action.type); } } } ``` -We recommend wrapping each `case` block into the `{` and `}` curly braces so that variables declared inside of different `case`s don't clash with each other. Also, a `case` should usually end with a `return`. If you forget to `return`, the code will "fall through" to the next `case`, which can lead to mistakes! +Nous recommandons d'enrober chaque bloc `case` entre des accolades `{` et `}` afin qu'il n'y ait pas d'interférences entre les variables d'éclarées dans chaque `case` distinct. De plus, un `case` doit généralement se terminer par un `return`. Si vous l'oubliez, le code va « continuera » sur le `case` suivant, ce qui peut entraîner des erreurs ! -If you're not yet comfortable with switch statements, using if/else is completely fine. +Si vous n'êtes pas à l'aise avec les instructions `switch`, vous pouvez tout à fait utiliser des `if` / `else`. -#### Why are reducers called this way? {/*why-are-reducers-called-this-way*/} +#### Pourquoi les réducteurs sont appelés ainsi ? {/*why-are-reducers-called-this-way*/} -Although reducers can "reduce" the amount of code inside your component, they are actually named after the [`reduce()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/Reduce) operation that you can perform on arrays. +Bien que les réducteurs peuvent « réduire » la taille du code dans votre composant, ils sont en réalité appelés ainsi d'après l'opération [`reduce()`](https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/Array/Reduce) que vous pouvez exécuter sur les tableaux. -The `reduce()` operation lets you take an array and "accumulate" a single value out of many: +L'opération `reduce()` permet de prendre un tableau puis « d'accumuler » une seule valeur parmi plusieurs : ``` const arr = [1, 2, 3, 4, 5]; @@ -392,9 +392,9 @@ const sum = arr.reduce( ); // 1 + 2 + 3 + 4 + 5 ``` -The function you pass to `reduce` is known as a "reducer". It takes the _result so far_ and the _current item,_ then it returns the _next result._ React reducers are an example of the same idea: they take the _state so far_ and the _action_, and return the _next state._ In this way, they accumulate actions over time into state. +La fonction que vous passez à `reduce` est appelée « réducteur ». Elle prend le _résultat en cours_ and l'_élément courant_, puis renvoie le _prochain résultat_. Les réducteurs React sont un exemple de la même idée : ils prennent _l'état en cours_ et une _action_, puis renvoient le _prochain état_. De cette façon, ils accumulent dans l'état les actions au fil du temps. -You could even use the `reduce()` method with an `initialState` and an array of `actions` to calculate the final state by passing your reducer function to it: +Vous pouvez même utiliser la méthode `reduce()` avec un `initialState` et un tableau d'`actions` pour calculer l'état final en lui passant votre fonction de réduction : @@ -403,10 +403,10 @@ import tasksReducer from './tasksReducer.js'; let initialState = []; let actions = [ - {type: 'added', id: 1, text: 'Visit Kafka Museum'}, - {type: 'added', id: 2, text: 'Watch a puppet show'}, + {type: 'added', id: 1, text: 'Visiter le musée de Kafka'}, + {type: 'added', id: 2, text: 'Voir un spectacle de marionnettes'}, {type: 'deleted', id: 1}, - {type: 'added', id: 3, text: 'Lennon Wall pic'}, + {type: 'added', id: 3, text: 'Faire une photo du mur de Lennon'}, ]; let finalState = actions.reduce(tasksReducer, initialState); @@ -441,7 +441,7 @@ export default function tasksReducer(tasks, action) { return tasks.filter((t) => t.id !== action.id); } default: { - throw Error('Unknown action: ' + action.type); + throw Error('Action inconnue : ' + action.type); } } } @@ -453,43 +453,42 @@ export default function tasksReducer(tasks, action) { -You probably won't need to do this yourself, but this is similar to what React does! +Vous n'aurez probablement pas besoin de le faire vous-même, mais c'est similaire à ce que fait React ! -### Step 3: Use the reducer from your component {/*step-3-use-the-reducer-from-your-component*/} +### Étape 3 : utilisez le réducteur depuis votre composant {/*step-3-use-the-reducer-from-your-component*/} -Finally, you need to hook up the `tasksReducer` to your component. Import the `useReducer` Hook from React: +Enfin, vous devez connecter le `tasksReducer` à votre composant. Importez le Hook `useReducer` depuis React : ```js import { useReducer } from 'react'; ``` -Then you can replace `useState`: +Ensuite, vous pouvez remplacer le `useState` : ```js const [tasks, setTasks] = useState(initialTasks); ``` -with `useReducer` like so: +par `useReducer` de cette façon : ```js const [tasks, dispatch] = useReducer(tasksReducer, initialTasks); ``` -The `useReducer` Hook is similar to `useState`—you must pass it an initial state and it returns a stateful value and a way to set state (in this case, the dispatch function). But it's a little different. +Le Hook `useReducer` est similaire à `useState` — vous devez passer un état initial and il renvoie une valeur d'état et un moyen de le redéfinir (dans ce cas, la fonction de *dispatch*). Toutefois, c'est un peu différent. -The `useReducer` Hook takes two arguments: +Le Hook `useReducer` prend deux arguments : -1. A reducer function -2. An initial state +1. Une fonction de réduction. +2. Un état initial. -And it returns: +et renvoie : -1. A stateful value -2. A dispatch function (to "dispatch" user actions to the reducer) +1. Un valeur d'état. +2. Un fonction *dispatch* (pour « *dispatcher* » les actions de l'utilisateur vers le réducteur). -Now it's fully wired up! Here, the reducer is declared at the bottom of the component file: @@ -525,7 +524,7 @@ export default function TaskApp() { return ( <> -

Prague itinerary

+

Voyage à Prague

t.id !== action.id); } default: { - throw Error('Unknown action: ' + action.type); + throw Error('Action inconnue : ' + action.type); } } } let nextId = 3; const initialTasks = [ - {id: 0, text: 'Visit Kafka Museum', done: true}, - {id: 1, text: 'Watch a puppet show', done: false}, - {id: 2, text: 'Lennon Wall pic', done: false}, + {id: 0, text: 'Visiter le musée de Kafka', done: true}, + {id: 1, text: 'Voir un spectacle de marionnettes', done: false}, + {id: 2, text: 'Faire une photo du mur de Lennon', done: false}, ]; ``` @@ -582,7 +581,7 @@ export default function AddTask({onAddTask}) { return ( <> setText(e.target.value)} /> @@ -628,14 +627,14 @@ function Task({task, onChange, onDelete}) { }); }} /> - + ); } else { taskContent = ( <> {task.text} - + ); } @@ -652,7 +651,7 @@ function Task({task, onChange, onDelete}) { }} /> {taskContent} - + ); } @@ -674,7 +673,7 @@ li {
-If you want, you can even move the reducer to a different file: +Si vous voulez, vous pouvez même déplacer le réducteur dans un fichier à part : @@ -711,7 +710,7 @@ export default function TaskApp() { return ( <> -

Prague itinerary

+

Voyage à Prague

t.id !== action.id); } default: { - throw Error('Unknown action: ' + action.type); + throw Error('Action inconnue : ' + action.type); } } } @@ -770,7 +769,7 @@ export default function AddTask({onAddTask}) { return ( <> setText(e.target.value)} /> @@ -816,14 +815,14 @@ function Task({task, onChange, onDelete}) { }); }} /> - + ); } else { taskContent = ( <> {task.text} - + ); } @@ -840,7 +839,7 @@ function Task({task, onChange, onDelete}) { }} /> {taskContent} - + ); } @@ -862,30 +861,30 @@ li {
-Component logic can be easier to read when you separate concerns like this. Now the event handlers only specify _what happened_ by dispatching actions, and the reducer function determines _how the state updates_ in response to them. +La logique des composants peut être plus simple à lire quand vous séparer les responsabilités de cette façon. Maintenant les gestionnaires d'événements ne spécifient plus que _ce qui s'est passé_ pour *dispatcher* les actions, et la fonction de réduction détermine _comment l'état se met à jour_ en réponse à ces actions. -## Comparing `useState` and `useReducer` {/*comparing-usestate-and-usereducer*/} +## Comparaison de `useState` et `useReducer` {/*comparing-usestate-and-usereducer*/} -Reducers are not without downsides! Here's a few ways you can compare them: +Les réducteurs ne sont pas sans inconvénients ! Voici quelques éléments de comparaison : -- **Code size:** Generally, with `useState` you have to write less code upfront. With `useReducer`, you have to write both a reducer function _and_ dispatch actions. However, `useReducer` can help cut down on the code if many event handlers modify state in a similar way. -- **Readability:** `useState` is very easy to read when the state updates are simple. When they get more complex, they can bloat your component's code and make it difficult to scan. In this case, `useReducer` lets you cleanly separate the _how_ of update logic from the _what happened_ of event handlers. -- **Debugging:** When you have a bug with `useState`, it can be difficult to tell _where_ the state was set incorrectly, and _why_. With `useReducer`, you can add a console log into your reducer to see every state update, and _why_ it happened (due to which `action`). If each `action` is correct, you'll know that the mistake is in the reducer logic itself. However, you have to step through more code than with `useState`. -- **Testing:** A reducer is a pure function that doesn't depend on your component. This means that you can export and test it separately in isolation. While generally it's best to test components in a more realistic environment, for complex state update logic it can be useful to assert that your reducer returns a particular state for a particular initial state and action. -- **Personal preference:** Some people like reducers, others don't. That's okay. It's a matter of preference. You can always convert between `useState` and `useReducer` back and forth: they are equivalent! +- **Taille du code** : généralement, avec un `useState`, vous devez écrire moi de code au début. Avec `useReducer`, vous devez écrire à la fois la fonction de réduction _et_ les actions de *dispatch*. Cependant, `useReducer` peut aider à réduire le code si de nombreux gestionnaires d'événements modifient l'état d'une façon similaire. +- **Lisibilité** : `useState` est très facile à lire lorsque les mises à jour d'état sont simples. Quand ça se complique, elles peuvent gonfler le code de votre composant et le rendre difficile à analyser. Dans ce cas, `useReducer` vous permet de séparer proprement le _comment_ de la logique de _ce qui est arrivé_ des gestionnaires d'événements. +- **Débogage** : quand vous avez un bug avec un `useState`, il peut être difficile de dire _où_ l'état a été définit incorrectement et _pourquoi_. Avec un `useReducer`, vous pouvez ajouter des messages dans la console dans votre réducteur pour voir chaque mise à jour d'état and _pourquoi_ elles ont lieu (en rapport à quelle `action`). Si chaque `action` est correcte, vous saurez que le problème se trouve dans la logique de réduction elle-même. Cependant, vous devez parcourir plus de code qu'avec `useState`. +- **Tests** : un réducteur est une fonction pure qui ne dépend pas de votre composant. Ça signifie que vous pouvez l'exporter et la tester en isolation. Bien qu'il soit généralement préférable de tester des composants dans un environnement plus réaliste, pour une logique de mise à jour d'état plus complexe, il peut être utilise de vérifier que votre réducteur renvoie un état particulier pour un état initial et une action particuliers. +- **Préférence personnelle** : certaines personnes aiment les réducteurs, d'autres non. Ce n'est pas grave. C'est une question de préférence. Vous pouvez toujours convertir un `useState` en un `useReducer` et inversement : ils sont équivalents ! -We recommend using a reducer if you often encounter bugs due to incorrect state updates in some component, and want to introduce more structure to its code. You don't have to use reducers for everything: feel free to mix and match! You can even `useState` and `useReducer` in the same component. +Nous recommandons d'utiliser un réducteur si vous rencontrez souvent des bugs à cause de mauvaises mises à jour de l'état dans certains composants et que vous souhaitez introduire plus de structure dans son code. Vous n'êtes pas obligé d'utiliser les réducteurs pour tout : n'hésitez pas à les mélanger ! Vous pouvez aussi utiliser `useState` et `useReducer` dans le même composant. -## Writing reducers well {/*writing-reducers-well*/} +## Écrire les réducteurs correctement {/*writing-reducers-well*/} -Keep these two tips in mind when writing reducers: +Gardez ces deux points à l'esprit quand vous écrivez des réducteurs : -- **Reducers must be pure.** Similar to [state updater functions](/learn/queueing-a-series-of-state-updates), reducers run during rendering! (Actions are queued until the next render.) This means that reducers [must be pure](/learn/keeping-components-pure)—same inputs always result in the same output. They should not send requests, schedule timeouts, or perform any side effects (operations that impact things outside the component). They should update [objects](/learn/updating-objects-in-state) and [arrays](/learn/updating-arrays-in-state) without mutations. -- **Each action describes a single user interaction, even if that leads to multiple changes in the data.** For example, if a user presses "Reset" on a form with five fields managed by a reducer, it makes more sense to dispatch one `reset_form` action rather than five separate `set_field` actions. If you log every action in a reducer, that log should be clear enough for you to reconstruct what interactions or responses happened in what order. This helps with debugging! +- **Les réducteurs doivent être purs**. Tout comme les [fonctions de mise à jour d'état](/learn/queueing-a-series-of-state-updates), les réducteurs sont exécutés durant le rendu (les actions sont mises en attente jusqu'au rendu suivant) ! Ça signifie que les réducteurs [doivent être purs](/learn/keeping-components-pure) — les mêmes entrées résultent toujours dans les mêmes sorties. Ils ne doivent pas envoyer de requêtes, planifier des *timeouts* ou effectuer des effets secondaires (des opérations qui impactent des éléments extérieurs au composant). Ils doivent mettre à jour des [objets](/learn/updating-objects-in-state) et [des tableaux](/learn/updating-arrays-in-state) sans modifications. +- **Chaque action décrit une interaction utilisateur unique, même si ça entraîne plusieurs modifications des données**. Par exemple, si un utilisateur appuie sur le bouton « Réinitialiser » d'un formulaire comportant cinq champs gérés par un réducteur, il sera plus logique de *dispatcher* une seule action `reset_form` plutôt que cinq actions `set_field` distinctes. Si vous enregistrez chaque action dans un réducteur, cet enregistrement doit être suffisament clair pour vous permettre de reconstruire les interactions ou les réponses qui se sont produites dans le bon ordre. Ça aide au débogage ! -## Writing concise reducers with Immer {/*writing-concise-reducers-with-immer*/} +## Écrire des réducteurs concis avec Immer {/*writing-concise-reducers-with-immer*/} -Just like with [updating objects](/learn/updating-objects-in-state#write-concise-update-logic-with-immer) and [arrays](/learn/updating-arrays-in-state#write-concise-update-logic-with-immer) in regular state, you can use the Immer library to make reducers more concise. Here, [`useImmerReducer`](https://github.com/immerjs/use-immer#useimmerreducer) lets you mutate the state with `push` or `arr[i] =` assignment: +Tout comme [mettre à jour des objets](/learn/updating-objects-in-state#write-concise-update-logic-with-immer) et [des tableaux](/learn/updating-arrays-in-state#write-concise-update-logic-with-immer) dans un état ordinaire, vous pouvez utiliser la bibliothèque Immer pour rendre les réducteurs plus concis. Ici,[`useImmerReducer`](https://github.com/immerjs/use-immer#useimmerreducer) vous permetez de modifier l'état avec une instruction `push` ou `arr[i] =` : @@ -913,7 +912,7 @@ function tasksReducer(draft, action) { return draft.filter((t) => t.id !== action.id); } default: { - throw Error('Unknown action: ' + action.type); + throw Error('Action inconnue : ' + action.type); } } } @@ -945,7 +944,7 @@ export default function TaskApp() { return ( <> -

Prague itinerary

+

Voyage à Prague

setText(e.target.value)} /> @@ -1018,14 +1017,14 @@ function Task({task, onChange, onDelete}) { }); }} /> - + ); } else { taskContent = ( <> {task.text} - + ); } @@ -1042,7 +1041,7 @@ function Task({task, onChange, onDelete}) { }} /> {taskContent} - + ); } @@ -1082,34 +1081,34 @@ li {
-Reducers must be pure, so they shouldn't mutate state. But Immer provides you with a special `draft` object which is safe to mutate. Under the hood, Immer will create a copy of your state with the changes you made to the `draft`. This is why reducers managed by `useImmerReducer` can mutate their first argument and don't need to return state. +Les réducteurs doivent être purs, donc ils ne doivent pas modifier l'état. Cependant, Immer fournit un objet spécial `draft` qu'il est possible de modifier. Sous le capot, Immer créera une copie de votre état avec les changements que vous avez appliqué sur le `draft`. C'est pourquoi les réducteurs gérés par `useImmerReducer` peuvent modifier leur premier argument et n'ont pas besoin de renvoyer l'état. -- To convert from `useState` to `useReducer`: - 1. Dispatch actions from event handlers. - 2. Write a reducer function that returns the next state for a given state and action. - 3. Replace `useState` with `useReducer`. -- Reducers require you to write a bit more code, but they help with debugging and testing. -- Reducers must be pure. -- Each action describes a single user interaction. -- Use Immer if you want to write reducers in a mutating style. +- Pour convertir `useState` vers `useReducer` : + 1. *Dispatchez* les actions depuis des gestionnaires d'événements. + 2. Écrivez une fonction de réduction qui renvoie le prochain état pour un état et une action donnés. + 3. Remplacez `useState` par `useReducer`. +- Les réducteurs vous obligent à écrire un peu plus de code, mais ils facilitent le débogage et les tests. +- Les réducteurs doivent être purs. +- Chaque action décrit une interaction utilisateur unique. +- Utilisez Immer si vous souhaitez écrire des réducteurs dans un style de modification. -#### Dispatch actions from event handlers {/*dispatch-actions-from-event-handlers*/} +#### *Dispatchez* des actions depuis des gestionnaires d'événements {/*dispatch-actions-from-event-handlers*/} -Currently, the event handlers in `ContactList.js` and `Chat.js` have `// TODO` comments. This is why typing into the input doesn't work, and clicking on the buttons doesn't change the selected recipient. +Pour l'instant, les gestionnaires d'événements dans `ContactList.js` et `Chat.js` contiennent des commentaires `// TODO`. C'est pour ça que taper dans le champ de saisie ne marche pas, et cliquer sur les boutons ne change pas le destinataire sélectionné. -Replace these two `// TODO`s with the code to `dispatch` the corresponding actions. To see the expected shape and the type of the actions, check the reducer in `messengerReducer.js`. The reducer is already written so you won't need to change it. You only need to dispatch the actions in `ContactList.js` and `Chat.js`. +Remplacez ces deux commentaires `// TODO` avec le code faisant le `dispatch` des actions correspondantes. Pour voir la forme attendue et le type des actions, vérifiez le réducteur dans `messengerReducer.js`. Il est déjà écrit, vous n'avez donc pas besoin de le changer. Vous devez seulement *dispatcher* les actions dans `ContactList.js` et `Chat.js`. -The `dispatch` function is already available in both of these components because it was passed as a prop. So you need to call `dispatch` with the corresponding action object. +La fonction `dispatch` est déjà disponible dans les deux composants parce qu'elle a été passée comme une prop. Vous devez donc appeler `dispatch`avec l'objet d'action correspondant. -To check the action object shape, you can look at the reducer and see which `action` fields it expects to see. For example, the `changed_selection` case in the reducer looks like this: +Pour vérifier la forme de l'objet d'action, vous pouvez regarder le réducteur et voir quels champs d'`action` il s'attend à avoir. Par exemple, le cas de l'action `changed_selection` du réducteur ressemble à ceci : ```js case 'changed_selection': { @@ -1120,7 +1119,7 @@ case 'changed_selection': { } ``` -This means that your action object should have a `type: 'changed_selection'`. You also see the `action.contactId` being used, so you need to include a `contactId` property into your action. +Ça signifie que votre objet d'action doit avoir `type: 'changed_selection'`. Vous remarquez aussi que le `action.contactId` est utilisé, vous devez donc inclure une propriété `contactId` dans votre action. @@ -1163,7 +1162,7 @@ const contacts = [ ```js messengerReducer.js export const initialState = { selectedId: 0, - message: 'Hello', + message: 'Bonjour', }; export function messengerReducer(state, action) { @@ -1182,7 +1181,7 @@ export function messengerReducer(state, action) { }; } default: { - throw Error('Unknown action: ' + action.type); + throw Error('Action inconnue : ' + action.type); } } } @@ -1197,7 +1196,7 @@ export default function ContactList({contacts, selectedId, dispatch}) {
  • @@ -1217,14 +1216,14 @@ export default function Chat({contact, message, dispatch}) {