Qu'est-ce que React ?
React est une bibliothèque JavaScript créée par Facebook en 2013 pour construire des interfaces utilisateur. L'idée centrale : découper l'interface en petits morceaux réutilisables appelés composants.
En React, une interface n'est pas un fichier HTML monolithique. C'est un assemblage de composants — chacun a son propre code, sa propre logique, et peut être réutilisé partout. Un bouton, une carte, un formulaire — tout est un composant.
node --version — il faut la version 18 ou supérieure. Téléchargeable sur nodejs.org.mon-projet/ ├── src/ │ ├── App.jsx ← votre composant principal │ ├── App.css ← styles de App │ ├── main.jsx ← point d'entrée — ne pas modifier │ └── index.css ← styles globaux ├── public/ │ └── vite.svg ├── index.html ← page HTML principale ├── package.json ← liste des dépendances └── vite.config.js ← configuration Vite
Vous travaillerez principalement dans le dossier src/. On crée un nouveau fichier .jsx pour chaque composant.
Qu'est-ce que le JSX ?
JSX (JavaScript XML) est une extension de syntaxe qui permet d'écrire du HTML directement dans le JavaScript. C'est ce qui donne à React son côté naturel et expressif.
{"// Créer un élément sans JSX"} const el = React.createElement( 'h1', { className: 'titre' }, 'Bonjour !' ); {"// Très difficile à lire..."}
{"// Même résultat avec JSX"} const el = ( <h1 className="titre"> Bonjour ! </h1> ); {"// On reconnaît le HTML ✓"}
.jsx.| HTML | JSX | Pourquoi |
|---|---|---|
class= | className= | class est un mot réservé en JavaScript |
for= | htmlFor= | for est un mot réservé en JavaScript |
onclick= | onClick= | Attributs en camelCase en JSX |
style="color:red" | style={{ color: 'red' }} | Style est un objet JS en JSX |
<br> | <br /> | Toutes les balises doivent être fermées |
<img> | <img /> | Même règle — auto-fermante |
Écrire son premier composant
Un composant React est une fonction JavaScript qui retourne du JSX. C'est tout. Une fonction, un return, du JSX. La simplicité est la force de React.
{"// 1. Une fonction JavaScript (nom en PascalCase)"} function Bonjour() { {"// 2. Elle retourne du JSX"} return ( <div> <h1>Bonjour, React !</h1> <p>Mon premier composant.</p> </div> ); } {"// 3. On l'exporte pour pouvoir l'utiliser ailleurs"} export default Bonjour;
{"// 1. Importer le composant"} import Bonjour from './Bonjour'; function App() { return ( <div> <h1>Mon application</h1> {"// 2. Utiliser comme une balise — majuscule obligatoire !"} <Bonjour /> {"// 3. On peut l'utiliser plusieurs fois"} <Bonjour /> <Bonjour /> </div> ); } export default App;
function CarteEtudiant() { {"// Variables JavaScript dans le composant"} const nom = 'Fatou Diallo'; const filiere = 'Informatique'; const note = 17; const annee = new Date().getFullYear(); return ( <div> {"// { } pour insérer une expression JS dans le JSX"} <h2>{nom}</h2> <p>Filière : {filiere}</p> <p>Note : {note}/20</p> <p>Promo {annee}</p> <p>Mention : {note >= 16 ? 'Très bien' : 'Bien'}</p> </div> ); }
Les règles fondamentales du JSX
JSX a des règles strictes. Les ignorer produit des erreurs incompréhensibles. Voici les 4 règles à connaître absolument.
return ( {"// ❌ Deux éléments au même niveau"} <h1>Titre</h1> <p>Texte</p> );
return ( {"// ✓ Un seul élément parent"} <div> <h1>Titre</h1> <p>Texte</p> </div> );
<>...</> (Fragment vide). Ça regroupe les éléments sans créer de balise HTML.
return ( <> {"← Fragment — invisible dans le DOM"} <h1>Titre</h1> <p>Texte</p> </> );
{"// ❌ Valide en HTML, interdit en JSX"} <img src="photo.jpg"> <br> <input type="text"> <hr>
{"// ✓ Toujours fermées en JSX"} <img src="photo.jpg" /> <br /> <input type="text" /> <hr />
{"// ❌ HTML → ✓ JSX"} <div class="carte"> {"→"} <div className="carte"> <label for="nom"> {"→"} <label htmlFor="nom"> {"// Le style est un OBJET JavaScript (double accolades)"} {"// ❌ style='color:red; font-size:16px'"} {"// ✓"} <p style={{ color: 'red', fontSize: '16px' }}>Texte</p> {"// ↑ 1ère {} = expression JS"} {"// ↑ 2ème {} = objet style"} {"// camelCase pour les propriétés : font-size → fontSize"}
{"// Minuscule → élément HTML natif"} <div> <p> <h1> <button> {"// Majuscule → composant React"} <CarteEtudiant /> <Bonjour /> <App /> {"// Si on écrit en minuscule un composant React :"} <carteEtudiant /> {"← React cherche une balise HTML 'carteetudiant' → erreur"}
Insérer du JavaScript avec les accolades
Les accolades { } dans le JSX permettent d'insérer n'importe quelle expression JavaScript — une variable, un calcul, un appel de fonction, un ternaire. C'est la "porte" entre JSX et JavaScript.
function Exemples() { const nom = 'Fatou'; const note = 17; const actif = true; const items = ['Maths', 'React', 'Node']; function getMention(n) { return n >= 16 ? 'Très bien' : 'Bien'; } return ( <div> {"// Variable"} <p>Nom : {nom}</p> {"// Calcul"} <p>Double : {note * 2}</p> {"// Appel de fonction"} <p>Mention : {getMention(note)}</p> {"// Ternaire (si/sinon)"} <p>{actif ? 'Actif' : 'Inactif'}</p> {"// Méthode de tableau"} <p>{items.join(', ')}</p> {"// Dans les attributs"} <img src={`/photos/${nom}.jpg`} alt={nom} /> </div> ); }
Nommage & conventions React
React a des conventions de nommage strictes que toute la communauté respecte. Les appliquer dès le début vous évitera des erreurs et rendra votre code lisible par n'importe quel développeur React.
-
✓Composants en PascalCase
CarteEtudiant·FormulaireConnexion·BoutonValider
Chaque mot commence par une majuscule, sans séparateur -
✓Fichiers de composants : PascalCase.jsx
CarteEtudiant.jsx·App.jsx·Navbar.jsx
Le nom du fichier = le nom du composant -
✓Variables et fonctions : camelCase
const nomEtudiant·function handleClick()·const estActif
Premier mot en minuscule, suivants avec majuscule -
✓Handlers d'événements : handle + action
handleClick·handleSubmit·handleChange
Convention universelle pour les fonctions d'événement -
✗Éviter les noms non descriptifs
const x·function fn()·const data
Un nom doit décrire ce qu'il contient ou fait
src/ ├── components/ ← composants réutilisables │ ├── CarteEtudiant.jsx │ ├── Navbar.jsx │ └── BoutonValider.jsx ├── pages/ ← pages de l'application │ ├── Accueil.jsx │ └── ListeEtudiants.jsx ├── App.jsx ← composant racine └── main.jsx ← point d'entrée
Comprendre main.jsx et App.jsx
Deux fichiers sont au cœur de tout projet React. Comprendre leur rôle évite beaucoup de confusions au départ.
import React from 'react'; import ReactDOM from 'react-dom/client'; import App from './App.jsx'; import './index.css'; {"// ReactDOM.createRoot() branche React sur la div#root du HTML"} ReactDOM .createRoot(document.getElementById('root')) .render(<App />); {"// → Dans index.html : "} {"// React prend le contrôle de cette div et affiche App"}
{"// Importer les composants qu'on veut afficher"} import Navbar from './components/Navbar'; import CarteEtudiant from './components/CarteEtudiant'; function App() { return ( <div> <Navbar /> <main> <h1>Liste des étudiants</h1> <CarteEtudiant /> <CarteEtudiant /> <CarteEtudiant /> </main> </div> ); } export default App;
| Concept | Syntaxe clé | À retenir |
|---|---|---|
| Composant | function Nom() { return <jsx /> } | Nom en PascalCase, un seul return |
| Export | export default NomComposant | Toujours à la fin du fichier |
| Import | import Nom from './Fichier' | Chemin relatif avec ./ ou ../ |
| Utiliser | <NomComposant /> | Comme une balise HTML, majuscule obligatoire |
| Expression JS | {variable} ou {calcul} | N'importe quelle expression, pas d'instruction |
| className | className="ma-classe" | Pas class — mot réservé JS |
| Élément racine | <div>...</div> ou <>...</> | Un seul élément parent dans le return |
Quiz & Travaux pratiques
4 questions pour valider la session, puis 3 exercices pratiques à réaliser dans votre projet Vite.
nom dans du JSX ?class en JSX ?npm create vite@latest). Installez les dépendances et lancez le serveur. Ouvrez App.jsx et supprimez tout le contenu existant. Remplacez-le par un composant simple qui affiche votre nom, votre filière et l'année en cours (avec new Date().getFullYear()). Vérifiez que votre page s'affiche correctement dans le navigateur.
src/, créez un fichier CarteEtudiant.jsx. Le composant affiche : nom, filière, note sur 20, et une mention calculée (note >= 16 → "Très bien", note >= 14 → "Bien", sinon "Passable") via un ternaire ou une fonction. Exportez le composant et importez-le dans App.jsx. Affichez-le 3 fois avec des données différentes écrites en dur dans le composant.
src/components/ : Entete.jsx (titre + sous-titre de la page), CarteEtudiant.jsx (comme l'exercice 2), PiedPage.jsx (copyright + année courante). Dans App.jsx, importez et assemblez les 3 composants pour former une page complète. Appliquez un style minimal avec className et les styles dans App.css.