diff --git a/src/content/learn/tutorial-tic-tac-toe.md b/src/content/learn/tutorial-tic-tac-toe.md
index 28d997b04..cbb546f1b 100644
--- a/src/content/learn/tutorial-tic-tac-toe.md
+++ b/src/content/learn/tutorial-tic-tac-toe.md
@@ -1,31 +1,33 @@
---
-title: 'Tutorial: Tic-Tac-Toe'
+title: 'Tutoriel : Tic-Tac-Toe'
---
-You will build a small tic-tac-toe game during this tutorial. This tutorial does not assume any existing React knowledge. The techniques you'll learn in the tutorial are fundamental to building any React app, and fully understanding it will give you a deep understanding of React.
+Dans ce tutoriel, vous allez construire un petit jeu de tic-tac-toe. Ce tutoriel ne requiert aucune connaissance préalable de React. Les techniques que vous apprendrez dans ce tutoriel sont fondamentales pour construire n'importe quelle appli React : bien les comprendre vous donnera une compréhension profonde de React.
-This tutorial is designed for people who prefer to **learn by doing** and want to quickly try making something tangible. If you prefer learning each concept step by step, start with [Describing the UI.](/learn/describing-the-ui)
+Ce tutoriel est conçu pour les personnes qui préfèrent **apprendre en faisant** et qui veulent essayer de produire rapidement quelque chose de concret. Si vous préférez apprendre chaque concept pas à pas, commencez à la page [Décrire l'UI](/learn/describing-the-ui).
-The tutorial is divided into several sections:
+Ce tutoriel est découpé en plusieurs sections :
-- [Setup for the tutorial](#setup-for-the-tutorial) will give you **a starting point** to follow the tutorial.
-- [Overview](#overview) will teach you **the fundamentals** of React: components, props, and state.
-- [Completing the game](#completing-the-game) will teach you **the most common techniques** in React development.
-- [Adding time travel](#adding-time-travel) will give you **a deeper insight** into the unique strengths of React.
+- [Se préparer au tutoriel](#setup-for-the-tutorial) vous donnera **un point de départ** pour le tutoriel.
+- [Survol](#overview) vous apprendra **les fondamentaux** de React : composants, props et état.
+- [Finaliser le jeu](#completing-the-game) vous apprendra **les techniques les plus courantes** du développement React.
+- [Voyager dans le temps](#adding-time-travel) vous donnera **une meilleure perception** des avantages uniques de React.
-### What are you building? {/*what-are-you-building*/}
+### Qu'allez-vous construire ? {/*what-are-you-building*/}
-In this tutorial, you'll build an interactive tic-tac-toe game with React.
+Dans ce tutoriel, vous allez construire un jeu de tic-tac-toe interactif avec React.
-You can see what it will look like when you're finished here:
+*(Le tic-tac-toe est souvent appelé par amalgame « morpion » en français ; les deux termes existent, mais le morpion n'est pas limité à 3 × 3 cases, NdT.)*
+
+Vous pouvez voir ci-dessous à quoi ça ressemblera une fois terminé :
@@ -57,9 +59,9 @@ function Board({ xIsNext, squares, onPlay }) {
const winner = calculateWinner(squares);
let status;
if (winner) {
- status = 'Winner: ' + winner;
+ status = winner + ' a gagné';
} else {
- status = 'Next player: ' + (xIsNext ? 'X' : 'O');
+ status = 'Prochain tour : ' + (xIsNext ? 'X' : 'O');
}
return (
@@ -103,9 +105,9 @@ export default function Game() {
const moves = history.map((squares, move) => {
let description;
if (move > 0) {
- description = 'Go to move #' + move;
+ description = 'Aller au coup #' + move;
} else {
- description = 'Go to game start';
+ description = 'Revenir au début';
}
return (
@@ -194,15 +196,15 @@ body {
-If the code doesn't make sense to you yet, or if you are unfamiliar with the code's syntax, don't worry! The goal of this tutorial is to help you understand React and its syntax.
+Si le code vous paraît incompréhensible, ou si des éléments de syntaxe vous semblent étranges, ne vous inquiétez pas ! L'objectif de ce tutoriel, c'est justement de vous aider à comprendre React et sa syntaxe.
-We recommend that you check out the tic-tac-toe game above before continuing with the tutorial. One of the features that you'll notice is that there is a numbered list to the right of the game's board. This list gives you a history of all of the moves that have occurred in the game, and it is updated as the game progresses.
+Nous vous conseillons de manipuler le jeu de tic-tac-toe ci-dessus avant de continuer ce tutoriel. Une des fonctionnalités que vous pourrez remarquer, c'est la liste numérotée des coups à droite du plateau de jeu. Elle vous donne un historique de tous les coups joués lors de la partie, mise à jour au fil du temps.
-Once you've played around with the finished tic-tac-toe game, keep scrolling. You'll start with a simpler template in this tutorial. Our next step is to set you up so that you can start building the game.
+Lorsque vous aurez fini de vous amuser avec ce jeu de tic-tac-toe finalisé, reprenez votre lecture de la page. Pour ce tutoriel, vous commencerez avec un gabarit simple. Notre prochaine étape consiste à vous préparer pour commencer à construire le jeu.
-## Setup for the tutorial {/*setup-for-the-tutorial*/}
+## Se préparer au tutoriel {/*setup-for-the-tutorial*/}
-In the live code editor below, click **Fork** in the top-right corner to open the editor in a new tab using the website CodeSandbox. CodeSandbox lets you write code in your browser and preview how your users will see the app you've created. The new tab should display an empty square and the starter code for this tutorial.
+Dans l'éditeur de code interactif ci-dessous, cliquez sur **Fork** en haut à droite pour ouvrir l'éditeur dans un nouvel onglet sur le site web CodeSandbox. CodeSandbox vous permet d'écrire du code dans votre navigateur et de prévisualiser ce que verront les utilisateurs de l'appli que vous aurez créée. Le nouvel onglet devrait afficher un carré vide et le code de démarrage pour ce tutoriel.
@@ -261,33 +263,33 @@ body {
-You can also follow this tutorial using your local development environment. To do this, you need to:
+Vous pouvez aussi suivre ce tutoriel dans votre environnement de développement local. Pour cela, suivez ces étapes :
-1. Install [Node.js](https://nodejs.org/en/)
-1. In the CodeSandbox tab you opened earlier, press the top-left corner button to open the menu, and then choose **File > Export to ZIP** in that menu to download an archive of the files locally
-1. Unzip the archive, then open a terminal and `cd` to the directory you unzipped
-1. Install the dependencies with `npm install`
-1. Run `npm start` to start a local server and follow the prompts to view the code running in a browser
+1. Installez [Node.js](https://nodejs.org/fr/)
+2. Dans l'onglet CodeSandbox ouvert plus tôt, appuyez sur le bouton en haut à gauche pour ouvrir le menu, puis choisissez **File › Export to ZIP** dans ce menu pour télécharger localement une archive des fichiers du projet
+3. Décompressez le fichier d'archive puis ouvrez un terminal et faites un `cd` dans le dossier que vous venez de décompresser
+4. Installez les dépendances avec `npm install`
+5. Lancer `npm start` pour démarrer un serveur local et suivez les invites affichées pour voir le code s'exécuter dans le navigateur.
-If you get stuck, don't let this stop you! Follow along online instead and try a local setup again later.
+Si vous êtes bloqué·e, ne vous laissez pas décourager ! Suivez ce tutoriel en ligne et retentez une mise en place locale plus tard.
-## Overview {/*overview*/}
+## Survol {/*overview*/}
-Now that you're set up, let's get an overview of React!
+À présent que vous êtes prêt·e, attaquons un survol de React !
-### Inspecting the starter code {/*inspecting-the-starter-code*/}
+### Examiner le code de démarrage {/*inspecting-the-starter-code*/}
-In CodeSandbox you'll see three main sections:
+Dans CodeSandbox vous trouverez trois sections principales :
-![CodeSandbox with starter code](../images/tutorial/react-starter-code-codesandbox.png)
+![CodeSandbox avec le code de démarrage](../images/tutorial/react-starter-code-codesandbox.png)
-1. The _Files_ section with a list of files like `App.js`, `index.js`, `styles.css` and a folder called `public`
-1. The _code editor_ where you'll see the source code of your selected file
-1. The _browser_ section where you'll see how the code you've written will be displayed
+1. La section _Files_ contient une liste des fichiers du projet tels que `App.js`, `index.js`, `styles.css` et un dossier nommé `public`
+2. Le _code editor_ affiche le code source du fichier sélectionné
+3. Le _browser_ affiche le résultat du code que vous avez écrit
-The `App.js` file should be selected in the _Files_ section. The contents of that file in the _code editor_ should be:
+Le fichier `App.js` devrait être sélectionné dans la section _Files_. Le contenu de ce fichier dans le _code editor_ devrait être le suivant :
```jsx
export default function Square() {
@@ -295,15 +297,15 @@ export default function Square() {
}
```
-The _browser_ section should be displaying a square with a X in it like this:
+La section _browser_ devrait afficher un carré avec un X à l'intérieur, comme ceci :
-![x-filled square](../images/tutorial/x-filled-square.png)
+![Carré avec un X à l’intérieur](../images/tutorial/x-filled-square.png)
-Now let's have a look at the files in the starter code.
+Jetons maintenant un coup d'œil au code de démarrage.
#### `App.js` {/*appjs*/}
-The code in `App.js` creates a _component_. In React, a component is a piece of reusable code that represents a part of a user interface. Components are used to render, manage, and update the UI elements in your application. Let's look at the component line by line to see what's going on:
+Le code dans `App.js` crée un _composant_. Dans React, un composant est un bout de code réutilisable qui représente une partie de l'interface utilisateur (UI, pour *User Interface*). Les composants sont utilisés pour afficher, gérer et mettre à jour des éléments d'UI dans votre application. Examinons ce composant ligne par ligne pour voir ce qui s'y passe :
```js {1}
export default function Square() {
@@ -311,7 +313,7 @@ export default function Square() {
}
```
-The first line defines a function called `Square`. The `export` JavaScript keyword makes this function accessible outside of this file. The `default` keyword tells other files using your code that it's the main function in your file.
+La première ligne définit une fonction appelée `Square`. Le mot-clé JavaScript `export` rend cette fonction accessible à l'extérieur de ce fichier. Le mot-clé `default` indique aux autres fichiers utilisant votre code qu'il s'agit là de la fonction principale de votre fichier.
```js {2}
export default function Square() {
@@ -319,15 +321,15 @@ export default function Square() {
}
```
-The second line returns a button. The `return` JavaScript keyword means whatever comes after is returned as a value to the caller of the function. `` closes the JSX element to indicate that any following content shouldn't be placed inside the button.
+La deuxième ligne renvoie un bouton. Le mot-clé JavaScript `return` indique que tout ce qui le suit est renvoyé comme valeur à l'appelant de la fonction. `` ferme l'élément JSX en indiquant que tout ce qui suit ne devrait pas figurer dans le bouton.
#### `styles.css` {/*stylescss*/}
-Click on the file labeled `styles.css` in the _Files_ section of CodeSandbox. This file defines the styles for your React app. The first two _CSS selectors_ (`*` and `body`) define the style of large parts of your app while the `.square` selector defines the style of any component where the `className` property is set to `square`. In your code, that would match the button from your Square component in the `App.js` file.
+Cliquez sur le fichier nommé `styles.css` dans la section _Files_ de CodeSandbox. Ce fichier définit les styles de votre appli React. Les deux premiers _sélecteurs CSS_ (`*` et `body`) définissent le style de larges pans de votre appli, tandis que le sélecteur `.square` définit le style de tout composant dont la propriété `className` vaudra `square`. Dans votre code, ça correspondrait au bouton de votre composant `Square` dans le fichier `App.js`.
#### `index.js` {/*indexjs*/}
-Click on the file labeled `index.js` in the _Files_ section of CodeSandbox. You won't be editing this file during the tutorial but it is the bridge between the component you created in the `App.js` file and the web browser.
+Cliquez sur le fichier nommé `index.js` dans la section _Files_ de CodeSandbox. Vous ne modifierez pas ce fichier pendant ce tutoriel, mais il est la passerelle entre le composant que vous avez créé dans le fichier `App.js` et le navigateur web.
```jsx
import { StrictMode } from 'react';
@@ -337,20 +339,20 @@ import './styles.css';
import App from './App';
```
-Lines 1-5 brings all the necessary pieces together:
+Les lignes 1 à 5 rassemblent toutes les pièces du puzzle :
* React
-* React's library to talk to web browsers (React DOM)
-* the styles for your components
-* the component you created in `App.js`.
+* La bibliothèque React qui parle aux navigateurs web (React DOM)
+* Les styles de vos composants
+* Le composant que vous avez créé dans `App.js`.
-The remainder of the file brings all the pieces together and injects the final product into `index.html` in the `public` folder.
+Le reste du fichier connecte tout ça et injecte le résultat final dans `index.html` au sein du dossier `public`.
-### Building the board {/*building-the-board*/}
+### Construire le plateau de jeu {/*building-the-board*/}
-Let's get back to `App.js`. This is where you'll spend the rest of the tutorial.
+Revenons à `App.js`. C'est là que vous passerez le reste de ce tutoriel.
-Currently the board is only a single square, but you need nine! If you just try and copy paste your square to make two squares like this:
+À ce stade, le plateau n'est constitué que d'une seule case, mais il vous en faut neuf ! Si vous vous contentez de copier-coller votre carré pour en faire deux, comme ceci :
```js {2}
export default function Square() {
@@ -358,7 +360,7 @@ export default function Square() {
}
```
-You'll get this error:
+…vous obtiendrez cette erreur :
@@ -366,7 +368,9 @@ You'll get this error:
-React components need to return a single JSX element and not multiple adjacent JSX elements like two buttons. To fix this you can use *fragments* (`<>` and `>`) to wrap multiple adjacent JSX elements like this:
+*(« Des éléments JSX adjacents doivent être enrobés par une balise englobante. Vouliez-vous utiliser un Fragment JSX `<>...>` ? », NdT.)*
+
+Les composants React doivent ne renvoyer qu'un unique élément JSX, et non plusieurs éléments JSX adjacents, comme nos deux boutons. Pour corriger ça, vous pouvez utiliser des *Fragments* (`<>` et `>`) pour enrober plusieurs éléments JSX adjacents, comme ceci :
```js {3-6}
export default function Square() {
@@ -379,17 +383,17 @@ export default function Square() {
}
```
-Now you should see:
+Vous devriez maintenant voir ça :
-![two x-filled squares](../images/tutorial/two-x-filled-squares.png)
+![Deux carrés avec des X à l’intérieur](../images/tutorial/two-x-filled-squares.png)
-Great! Now you just need to copy-paste a few times to add nine squares and...
+Super ! Maintenant vous n'avez plus qu'à copier-coller davantage pour obtenir neuf carrés…
-![nine x-filled squares in a line](../images/tutorial/nine-x-filled-squares.png)
+![Neuf carrés sur une ligne, avec des X à l’intérieur](../images/tutorial/nine-x-filled-squares.png)
-Oh no! The squares are all in a single line, not in a grid like you need for our board. To fix this you'll need to group your squares into rows with `div`s and add some CSS classes. While you're at it, you'll give each square a number to make sure you know where each square is displayed.
+Disgrâce ! Les carrés sont tous sur la même ligne, au lieu de former une grille comme nous en avons besoin pour notre plateau. Pour corriger ça, vous allez devoir grouper vos carrés en ligne avec des `div` et ajouter quelques classes CSS. Tant que vous y êtes, donnez un numéro à chaque carré pour être sûr·e que vous savez où chaque carré est affiché.
-In the `App.js` file, update the `Square` component to look like this:
+Dans le fichier `App.js`, mettez à jour votre composant `Square` pour ressembler à ceci :
```js {3-19}
export default function Square() {
@@ -415,11 +419,11 @@ export default function Square() {
}
```
-The CSS defined in `styles.css` styles the divs with the `className` of `board-row`. Now that you've grouped your components into rows with the styled `div`s you have your tic-tac-toe board:
+Le CSS défini dans `styles.css` style les `div` dotés de la `className` de valeur `board-row`. À présent que vous avez groupé vos composants en ligne avec ces `div` mis en page, vous avez votre plateau de tic-tac-toe :
-![tic-tac-toe board filled with numbers 1 through 9](../images/tutorial/number-filled-board.png)
+![plateau de tic-tac-toe rempli par les numéros 1 à 9](../images/tutorial/number-filled-board.png)
-But you now have a problem. Your component named `Square`, really isn't a square anymore. Let's fix that by changing the name to `Board`:
+Mais nous avons un problème. Votre composant nommé `Square` n'est plus vraiment un carré tout seul. Corrigeons ça en changeant son nom pour `Board` :
```js {1}
export default function Board() {
@@ -427,7 +431,7 @@ export default function Board() {
}
```
-At this point your code should look something like this:
+À ce stade, votre code devrait ressembler à ceci :
@@ -504,15 +508,15 @@ body {
-Psssst... That's a lot to type! It's okay to copy and paste code from this page. However, if you're up for a little challenge, we recommend only copying code that you've manually typed at least once yourself.
+Psssst… Ça fait un paquet de saisie de code ! N'hésitez pas à copier-coller le code de cette page. Ceci dit, si vous vous en sentez la force, nous vous conseillons de ne copier que le code que vous avez déjà tapé manuellement au moins une fois vous-même.
-### Passing data through props {/*passing-data-through-props*/}
+### Fournir des données avec les props {/*passing-data-through-props*/}
-Next, you'll want to change the value of a square from empty to "X" when the user clicks on the square. With how you've built the board so far you would need to copy-paste the code that updates the square nine times (once for each square you have)! Instead of copy-pasting, React's component architecture allows you to create a reusable component to avoid messy, duplicated code.
+Pour l'étape suivante, vous allez vouloir changer la valeur d'un carré de vide à « X » lorsque l'utilisateur clique sur le carré. Vu comme vous avez construit votre tableau jusqu'ici, il vous faudrait copier-coller le code qui met à jour un carré neuf fois (une fois par carré) ! Plutôt que de le copier-coller, l'architecture de composants de React vous permet de créer un composant réutilisable pour éviter du code dupliqué mal fichu.
-First, you are going to copy the line defining your first square (``) from your `Board` component into a new `Square` component:
+Pour commencer, copiez la ligne qui définit votre premier carré (``) depuis votre composant `Board` vers un nouveau composant `Square` :
```js {1-3}
function Square() {
@@ -524,7 +528,7 @@ export default function Board() {
}
```
-Then you'll update the Board component to render that `Square` component using JSX syntax:
+Ensuite, mettez à jour le composant `Board` pour afficher un composant `Square` grâce à la syntaxe JSX :
```js {5-19}
// ...
@@ -551,15 +555,15 @@ export default function Board() {
}
```
-Note how unlike the browser `div`s, your own components `Board` and `Square` must start with a capital letter.
+Remarquez que contrairement aux `div` du navigateur, vos propres composants `Board` et `Square` doivent avoir un nom qui démarre par une lettre majuscule.
-Let's take a look:
+Voyons un peu le résultat :
-![one-filled board](../images/tutorial/board-filled-with-ones.png)
+![Un plateau rempli de chiffres un](../images/tutorial/board-filled-with-ones.png)
-Oh no! You lost the numbered squares you had before. Now each square says "1". To fix this, you will use *props* to pass the value each square should have from the parent component (`Board`) to its child (`Square`).
+Palsambleu ! Vous avez perdu les carrés numérotés que vous aviez jusque-là. À présent chaque carré dit « 1 ». Pour corriger ça, vous allez utiliser des *props* pour passer la valeur que chaque carré devrait avoir depuis le composant parent (`Board`) vers les enfants (`Square`).
-Update the `Square` component to read the `value` prop that you'll pass from the `Board`:
+Mettez à jour le composant `Square` pour lire une prop `value` que vous passerez depuis le `Board` :
```js {1}
function Square({ value }) {
@@ -567,9 +571,9 @@ function Square({ value }) {
}
```
-`function Square({ value })` indicates the Square component can be passed a prop called `value`.
+`function Square({ value })` indique que le composant `Square` peut recevoir une prop nommée `value`.
-Now you want to display that `value` instead of `1` inside every square. Try doing it like this:
+Utilisez maintenant la `value` plutôt que `1` dans l'affichage de chaque carré. Essayez comme ceci :
```js {2}
function Square({ value }) {
@@ -577,11 +581,11 @@ function Square({ value }) {
}
```
-Oops, this is not what you wanted:
+Zut, ça ne marche pas :
-![value-filled board](../images/tutorial/board-filled-with-value.png)
+![Un plateau rempli de « value »](../images/tutorial/board-filled-with-value.png)
-You wanted to render the JavaScript variable called `value` from your component, not the word "value". To "escape into JavaScript" from JSX, you need curly braces. Add curly braces around `value` in JSX like so:
+Vous vouliez afficher le contenu de la variable JavaScript nommée `value` au sein de votre composant, pas le mot “value”. Afin de « vous échapper vers JavaScript » depuis JSX, vous avez besoin d'accolades. Ajoutez des accolades autour de `value` dans votre JSX, comme ceci :
```js {2}
function Square({ value }) {
@@ -589,11 +593,11 @@ function Square({ value }) {
}
```
-For now, you should see an empty board:
+Pour le moment, vous devriez voir un plateau vide :
-![empty board](../images/tutorial/empty-board.png)
+![Un plateau vide](../images/tutorial/empty-board.png)
-This is because the `Board` component hasn't passed the `value` prop to each `Square` component it renders yet. To fix it you'll add the `value` prop to each `Square` component rendered by the `Board` component:
+C'est parce que le composant `Board` ne passe pas encore de prop `value` à chaque composant `Square` qu'il affiche. Corrigez ça en ajoutant une prop `value` adaptée pour chaque composant `Square` affichée par le composant `Board` :
```js {5-7,10-12,15-17}
export default function Board() {
@@ -619,11 +623,11 @@ export default function Board() {
}
```
-Now you should see a grid of numbers again:
+Vous devriez retrouver votre grille numérotée :
-![tic-tac-toe board filled with numbers 1 through 9](../images/tutorial/number-filled-board.png)
+![Un plateau de tic-tac-toe rempli des nombres 1 à 9](../images/tutorial/number-filled-board.png)
-Your updated code should look like this:
+Votre code à jour devrait ressembler à ceci :
@@ -702,14 +706,16 @@ body {
-### Making an interactive component {/*making-an-interactive-component*/}
+### Rendre le composant interactif {/*making-an-interactive-component*/}
-Let's fill the `Square` component with an `X` when you click it. Declare a function called `handleClick` inside of the `Square`. Then, add `onClick` to the props of the button JSX element returned from the `Square`:
+Faisons en sorte que le composant `Square` se remplisse d'un `X` lorsqu'on clique dessus.
+
+Déclarez une fonction appelée `handleClick` au sein du composant `Square`. Ensuite, ajoutez la prop `onClick` à l'élément JSX de bouton renvoyé par `Square` :
```js {2-4,9}
function Square({ value }) {
function handleClick() {
- console.log('clicked!');
+ console.log('cliqué !');
}
return (
@@ -723,19 +729,19 @@ function Square({ value }) {
}
```
-If you click on a square now, you should see a log saying `"clicked!"` in the _Console_ tab at the bottom of the _Browser_ section in CodeSandbox. Clicking the square more than once will log `"clicked!"` again. Repeated console logs with the same message will not create more lines in the console. Instead, you will see an incrementing counter next to your first `"clicked!"` log.
+ Désormais, si vous cliquez sur un carré, vous devriez voir un message disant `"cliqué !"` dans l'onglet _Console_ en bas de la section _Browser_ de CodeSandbox. Des clics supplémentaires devraient à nouveau y afficher `"cliqué !"`. Des logs multiples du même message n'ajouteront pas de lignes dans la console : vous verrez plutôt un compteur s'incrémenter à côté du premier message `"cliqué !"`.
-If you are following this tutorial using your local development environment, you need to open your browser's Console. For example, if you use the Chrome browser, you can view the Console with the keyboard shortcut **Shift + Ctrl + J** (on Windows/Linux) or **Option + ⌘ + J** (on macOS).
+Si vous suivez ce tutoriel dans votre environnement de développement local, vous aurez besoin d'ouvrir la console de votre navigateur. Par exemple, si vous utilisez un navigateur basé Chromium tel que Chrome, Edge ou Brave, vous pouvez ouvrir la console avec le raccourci clavier **Maj + Ctrl + J** (sur Windows/Linux) ou **Option + ⌘ + J** (sur macOS).
-As a next step, you want the Square component to "remember" that it got clicked, and fill it with an "X" mark. To "remember" things, components use *state*.
+Vous souhaitez maintenant que le composant `Square` « se souvienne » qu'on lui a cliqué dessus, et se remplisse alors avec la marque « X ». Pour « se souvenir » de choses, les composants utilisent *l'état*.
-React provides a special function called `useState` that you can call from your component to let it "remember" things. Let's store the current value of the `Square` in state, and change it when the `Square` is clicked.
+React fournit une fonction spéciale appelée `useState` que vous pouvez appeler depuis votre composant pour qu'il « se souvienne » de choses. Stockons donc la valeur actuelle de `Square` dans un état, et modifions-la quand on clique sur le `Square`.
-Import `useState` at the top of the file. Remove the `value` prop from the `Square` component. Instead, add a new line at the start of the `Square` that calls `useState`. Have it return a state variable called `value`:
+Importez `useState` au début du fichier. Retirez la prop `value` du composant `Square`. Remplacez-la par une nouvelle ligne au début de la fonction `Square` qui appelle `useState`. Faites-lui renvoyer une variable d'état appelée `value` :
```js {1,3,4}
import { useState } from 'react';
@@ -747,9 +753,9 @@ function Square() {
//...
```
-`value` stores the value and `setValue` is a function that can be used to change the value. The `null` passed to `useState` is used as the initial value for this state variable, so `value` here starts off equal to `null`.
+`value` stocke la valeur et `setValue` est une fonction qu'on peut utiliser pour modifier la valeur. Le `null` passé à `useState` est utilisé comme valeur initiale de la variable d'état, de sorte que `value` démarre ici à `null`.
-Since the `Square` component no longer accepts props anymore, you'll remove the `value` prop from all nine of the Square components created by the Board component:
+Puisque le composant `Square` n'accepte plus de props, vous pouvez retirer les props `value` des neuf composants `Square` créés dans le composant `Board` :
```js {6-8,11-13,16-18}
// ...
@@ -776,7 +782,7 @@ export default function Board() {
}
```
-Now you'll change `Square` to display an "X" when clicked. Replace the `console.log("clicked!");` event handler with `setValue('X');`. Now your `Square` component looks like this:
+Modifiez maintenant `Square` pour afficher un « X » quand on clique dessus. Remplacez le `console.log("cliqué !");` du gestionnaire d'événement par `setValue('X');`. À présent votre composant `Square` devrait ressembler à ceci :
```js {5}
function Square() {
@@ -797,13 +803,13 @@ function Square() {
}
```
-By calling this `set` function from an `onClick` handler, you're telling React to re-render that `Square` whenever its `
-Before you can implement `jumpTo`, you need the `Game` component to keep track of which step the user is currently viewing. To do this, define a new state variable called `currentMove`, defaulting to `0`:
+Avant de pouvoir implémenter `jumpTo`, il faut que le composant `Game` détermine le coup que l'utilisateur est en train de consulter. Ajoutez une variable d'état nommée `currentMove`, qui vaudra par défaut `0` :
```js {4}
export default function Game() {
@@ -2482,7 +2490,7 @@ export default function Game() {
}
```
-Next, update the `jumpTo` function inside `Game` to update that `currentMove`. You'll also set `xIsNext` to `true` if the number that you're changing `currentMove` to is even.
+Mettez alors à jour la fonction `jumpTo` dans `Game` pour mettre à jour `currentMove`. Pensez aussi à mettre `xIsNext` à `true` si le numéro cible de `currentMove` est pair.
```js {4-5}
export default function Game() {
@@ -2495,10 +2503,10 @@ export default function Game() {
}
```
-You will now make two changes to the `Game`'s `handlePlay` function which is called when you click on a square.
+Il faut maintenant apporter deux modifications à la fonction `handlePlay` de `Game`, appelée lorsqu'on clique sur une case.
-- If you "go back in time" and then make a new move from that point, you only want to keep the history up to that point. Instead of adding `nextSquares` after all items (`...` spread syntax) in `history`, you'll add it after all items in `history.slice(0, currentMove + 1)` so that you're only keeping that portion of the old history.
-- Each time a move is made, you need to update `currentMove` to point to the latest history entry.
+- Si vous « revenez en arrière » puis faites un nouveau coup à partir de ce point, vous voulez ne conserver l'historique que jusqu'à ce point. Au lieu d'ajouter ` nextSquares` après tous les éléments (avec la syntaxe de *spread* `...`) de `history`, vous voudrez l'ajouter après les éléments de `history.slice(0, currentMove + 1)`, pour ne garder que cette portion de l'historique d'origine.
+- À chaque coup, il faut mettre à jour `currentMove` pour pointer sur la dernière entrée d'historique.
```js {2-4}
function handlePlay(nextSquares) {
@@ -2509,7 +2517,7 @@ function handlePlay(nextSquares) {
}
```
-Finally, you will modify the `Game` component to render the currently selected move, instead of always rendering the final move:
+Pour finir, il faut modifier le composant `Game` pour afficher le coup actuellement sélectionné, plutôt que de toujours afficher le dernier coup :
```js {5}
export default function Game() {
@@ -2522,7 +2530,7 @@ export default function Game() {
}
```
-If you click on any step in the game's history, the tic-tac-toe board should immediately update to show what the board looked like after that step occurred.
+Si vous cliquez sur n'importe quelle étape de l'historique de la partie, le plateau de tic-tac-toe devrait immédiatement afficher l'état du plateau à cette étape-là.
@@ -2554,9 +2562,9 @@ function Board({ xIsNext, squares, onPlay }) {
const winner = calculateWinner(squares);
let status;
if (winner) {
- status = 'Winner: ' + winner;
+ status = winner + ' a gagné';
} else {
- status = 'Next player: ' + (xIsNext ? 'X' : 'O');
+ status = 'Prochain tour : ' + (xIsNext ? 'X' : 'O');
}
return (
@@ -2602,9 +2610,9 @@ export default function Game() {
const moves = history.map((squares, move) => {
let description;
if (move > 0) {
- description = 'Go to move #' + move;
+ description = 'Aller au coup #' + move;
} else {
- description = 'Go to game start';
+ description = 'Revenir au début';
}
return (
@@ -2693,11 +2701,11 @@ body {
-### Final cleanup {/*final-cleanup*/}
+### Nettoyage final {/*final-cleanup*/}
-If you look at the code very closely, you may notice that `xIsNext === true` when `currentMove` is even and `xIsNext === false` when `currentMove` is odd. In other words, if you know the value of `currentMove`, then you can always figure out what `xIsNext` should be.
+Si vous observez attentivement le code, vous remarquerez peut-être que `xIsNext === true` quand `currentMove` est pair, et que `xIsNext === false` quand `currentMove` est impair. En d'autre termes, si vous connaissez la valeur de `currentMove`, vous pouvez toujours déduire celle de `xIsNext`.
-There's no reason for you to store both of these in state. In fact, always try to avoid redundant state. Simplifying what you store in state reduces bugs and makes your code easier to understand. Change `Game` so that it doesn't store `xIsNext` as a separate state variable and instead figures it out based on the `currentMove`:
+Il n'y a dès lors aucune raison de stocker les deux informations dans l'état. En fait, vous devriez activement chercher à ne rien stocker de redondant dans l'état. Simplifier ce que vous y stockez réduit les bugs et facilite la compréhension de votre code. Modifiez `Game` de façon à ce qu'il ne stocke plus `xIsNext` comme une variable d'état distincte, mais le calcule plutôt sur base de `currentMove` :
```js {4,11,15}
export default function Game() {
@@ -2719,20 +2727,20 @@ export default function Game() {
}
```
-You no longer need the `xIsNext` state declaration or the calls to `setXIsNext`. Now, there's no chance for `xIsNext` to get out of sync with `currentMove`, even if you make a mistake while coding the components.
+Vous n'avez plus besoin de la déclaration de variable d'état `xIsNext`, ni d'appels à `setXIsNext`. Il n'y a du coup plus aucun risque que `xIsNext` et `currentMove` se désynchronisent, même si vous faisiez une erreur en codant un des composants.
-### Wrapping up {/*wrapping-up*/}
+### En résumé {/*wrapping-up*/}
-Congratulations! You've created a tic-tac-toe game that:
+Félicitations ! Vous avez créé un jeu de tic-tac-toe qui :
-- Lets you play tic-tac-toe,
-- Indicates when a player has won the game,
-- Stores a game's history as a game progresses,
-- Allows players to review a game's history and see previous versions of a game's board.
+- vous permet de jouer au tic-tac-toe,
+- signale lorsqu'un joueur a gagné la partie,
+- stocke l'historique des coups au fil de la progression,
+- permet aux joueurs de revoir l'historique de la partie en affichant les plateaux de chaque coup.
-Nice work! We hope you now feel like you have a decent grasp of how React works.
+Beau boulot ! Nous espérons que vous avez désormais l'impression de raisonnablement comprendre comment fonctionne React.
-Check out the final result here:
+Le résultat final est ici :
@@ -2764,9 +2772,9 @@ function Board({ xIsNext, squares, onPlay }) {
const winner = calculateWinner(squares);
let status;
if (winner) {
- status = 'Winner: ' + winner;
+ status = winner + ' a gagné';
} else {
- status = 'Next player: ' + (xIsNext ? 'X' : 'O');
+ status = 'Prochain tour : ' + (xIsNext ? 'X' : 'O');
}
return (
@@ -2810,9 +2818,9 @@ export default function Game() {
const moves = history.map((squares, move) => {
let description;
if (move > 0) {
- description = 'Go to move #' + move;
+ description = 'Aller au coup #' + move;
} else {
- description = 'Go to game start';
+ description = 'Revenir au début';
}
return (
@@ -2901,12 +2909,12 @@ body {
-If you have extra time or want to practice your new React skills, here are some ideas for improvements that you could make to the tic-tac-toe game, listed in order of increasing difficulty:
+Si vous avez un peu plus de temps ou souhaitez pratiquer vos compétences React toutes fraîches, voici quelques idées d'améliorations que vous pourriez apporter à ce jeu de tic-tac-toe, par ordre croissant de difficulté :
-1. For the current move only, show "You are at move #..." instead of a button.
-1. Rewrite `Board` to use two loops to make the squares instead of hardcoding them.
-1. Add a toggle button that lets you sort the moves in either ascending or descending order.
-1. When someone wins, highlight the three squares that caused the win (and when no one wins, display a message about the result being a draw).
-1. Display the location for each move in the format (row, col) in the move history list.
+1. Pour le coup actuel uniquement, affichez « Vous êtes au coup #… » plutôt qu'un bouton.
+2. Remaniez `Board` pour qu'il utilise deux boucles au lieu de coder les rangées et cases du plateau en dur.
+3. Ajoutez un bouton de bascule qui permet de trier les coups par ordre croissant (du premier au dernier) ou décroissant (du dernier au premier).
+4. Lorsqu'un joueur gagne, mettez en exergue les trois cases qui constituent sa victoire (et si personne ne gagne, affichez un message indiquant un match nul).
+5. Affichez l'emplacement de chaque coup (ligne, colonne) dans l'historique des coups joués.
-Throughout this tutorial, you've touched on React concepts including elements, components, props, and state. Now that you've seen how these concepts work when building a game, check out [Thinking in React](/learn/thinking-in-react) to see how the same React concepts work when build an app's UI.
+Au cours de ce tutoriel, vous avez abordé des concepts React tels que les éléments, les composants, les props et l'état. À présent que vous avez pu les voir en action dans le cadre de la construction de ce jeu, allez donc lire [Penser en React](/learn/thinking-in-react) pour explorer ces mêmes concepts dans le cadre de la construction de l'UI d'une appli.
diff --git a/src/sidebarHome.json b/src/sidebarHome.json
index 1a8367114..e6c0d6899 100644
--- a/src/sidebarHome.json
+++ b/src/sidebarHome.json
@@ -4,10 +4,10 @@
"routes": [
{
"hasSectionHeader": true,
- "sectionHeader": "GET STARTED"
+ "sectionHeader": "DÉMARRAGE"
},
{
- "title": "Quick Start",
+ "title": "Démarrage rapide",
"path": "/learn"
},
{
@@ -16,10 +16,10 @@
},
{
"hasSectionHeader": true,
- "sectionHeader": "LEARN REACT"
+ "sectionHeader": "APPRENDRE REACT"
},
{
- "title": "Describing the UI",
+ "title": "Décrire l’UI",
"path": "/learn/describing-the-ui"
},
{
@@ -27,67 +27,67 @@
"path": "/learn/adding-interactivity"
},
{
- "title": "Managing State",
+ "title": "Gérer l'état",
"path": "/learn/managing-state"
},
{
- "title": "Escape Hatches",
+ "title": "Échappatoires",
"path": "/learn/escape-hatches"
},
{
"hasSectionHeader": true,
- "sectionHeader": "REACT API"
+ "sectionHeader": "API REACT"
},
{
"title": "Hooks",
"path": "/reference/react"
},
{
- "title": "Components",
+ "title": "Composants",
"path": "/reference/react/components"
},
{
- "title": "APIs",
+ "title": "Fonctions",
"path": "/reference/react/apis"
},
{
- "title": "Legacy APIs",
+ "title": "API React historique",
"path": "/reference/react/legacy"
},
{
"hasSectionHeader": true,
- "sectionHeader": "REACT DOM API"
+ "sectionHeader": "API REACT DOM"
},
{
- "title": "Components",
+ "title": "Composants",
"path": "/reference/react-dom/components"
},
{
- "title": "APIs",
+ "title": "Fonctions",
"path": "/reference/react-dom"
},
{
- "title": "Client APIs",
+ "title": "Fonctions côté client",
"path": "/reference/react-dom/client"
},
{
- "title": "Server APIs",
+ "title": "Fonctions côté serveur",
"path": "/reference/react-dom/server"
},
{
"hasSectionHeader": true,
- "sectionHeader": "GET INVOLVED"
+ "sectionHeader": "S’IMPLIQUER"
},
{
- "title": "React Community",
+ "title": "Communauté React",
"path": "/community"
},
{
"hasSectionHeader": true,
- "sectionHeader": "STAY INFORMED"
+ "sectionHeader": "RESTER INFORMÉ·E"
},
{
- "title": "React Blog",
+ "title": "Blog React",
"path": "/blog"
}
]
diff --git a/src/sidebarLearn.json b/src/sidebarLearn.json
index 7d527e973..9d5b0b9e0 100644
--- a/src/sidebarLearn.json
+++ b/src/sidebarLearn.json
@@ -11,7 +11,7 @@
"path": "/learn",
"routes": [
{
- "title": "Tutorial: Tic-Tac-Toe",
+ "title": "Tutoriel : Tic-Tac-Toe",
"path": "/learn/tutorial-tic-tac-toe"
},
{