Cours Vibe coding avec Claude Code · Module 3: Clone de Twitter

Le sceau du capitaine : les composants Post et PirateCard

9 min de lecture ·
Dans cette leçon9

La carte des routes est posée mais le fil n'affiche pour l'instant que l'auteur et le contenu. Un post doit recevoir un avatar rond et un bouton J'aime, et cela à deux endroits : dans le fil et sur la page d'un post isolé. Le profil, de son côté, doit montrer les cartes des pirates suivis. Si chaque page gardait sa propre copie du même JSX, changer la couleur du bouton J'aime voudrait dire corriger plusieurs fichiers, avec plusieurs occasions de se tromper.

Le composant : un sceau, beaucoup d'empreintes

React résout ce problème avec les composants. Un composant est une fonction qui renvoie du JSX, c'est-à-dire la description d'un morceau d'interface, et quand il n'a rien à montrer, il renvoie null. Un simple objet de données, par exemple { name: "Barbe-Rousse" }, React ne le dessinera pas. Le nom d'un composant commence par une majuscule, ce qui permet à React de distinguer <Post /> (ta fonction) de <div> (une balise HTML).

Pense au sceau du capitaine : il n'y a qu'un sceau, mais les listes peuvent porter autant d'empreintes que tu veux. Les données qui différencient les empreintes, tu les passes par les props. Elles fonctionnent comme les arguments d'une fonction : le parent les écrit comme des attributs HTML, et le composant ne fait que les lire. TypeScript les décrit avec une interface de la leçon 1_4, donc une faute de frappe dans le nom d'une prop, ou un texte à la place d'un nombre, finit en erreur au build, et non en carte vide chez le joueur.

Demande pour Claude Code

La tâche touche cinq fichiers, mais ne laisse aucune décision à prendre : les noms, les props et les endroits d'utilisation sont dans la demande. Le mode Manual suffit, dans lequel tu approuves chaque modification. Quand la demande laisse des choix, commence par /plan, comme dans la leçon 2_1.

Demande pour Claude Code :

Extrais de la messagerie deux composants, chacun dans son propre
fichier dans components/. Post : props author, avatar, content
(textes) et likes (nombre), avec un avatar rond et un bouton J'aime
qui pour l'instant ne fait qu'afficher le nombre. Utilise-le dans
@app/feed/page.tsx et dans @app/post/[id]/page.tsx. PirateCard :
props name, role, avatar et description facultative. Dans
@app/profile/page.tsx, montre sous le paragraphe du rôle la liste de
trois pirates suivis. Décris les props par une interface dans le
fichier du composant. Sans "use client" et sans état. Ne touche pas
à components/crew.tsx, car CrewCard appartient à la landing page.
À la fin, lance npm run build et npm run lint.

La demande nomme les fichiers, les props avec leurs types et les endroits d'utilisation, et les interdictions disent ce qu'il ne faut pas toucher. La dernière phrase exige une preuve, et non un rapport « c'est fait ».

Ce que Claude a écrit : PirateCard

Deux nouveaux fichiers sont apparus dans l'Explorateur, dans le dossier components/. Ouvre components/PirateCard.tsx. En haut se trouve le contrat sur les props :

interface PirateCardProps {
  name: string;
  role: string;
  avatar: string;
  description?: string;
}

Trois champs sont obligatoires, et le point d'interrogation de description? marque un champ facultatif : le parent peut l'omettre. L'interface ne change pas le fonctionnement de la carte dans le navigateur, puisque les types disparaissent à la compilation. Elle veille seulement à ce que les données respectent le contrat.

Sous l'interface se trouve le composant lui-même, exporté par défaut :

export default function PirateCard({ name, role, avatar, description }: PirateCardProps) {
  return (
    <article className="rounded-lg border border-gray-300 p-4">
      <div className="text-2xl font-bold">{avatar}</div>
      <h3 className="mt-2 text-lg font-bold">{name}</h3>
      <p className="text-gray-500">{role}</p>
      {description && <p className="mt-2 text-sm">{description}</p>}
    </article>
  );
}

L'écriture { name, role, avatar, description } extrait les props de l'objet que reçoit la fonction, et dans le JSX tu insères chaque valeur entre accolades. {description && ...} est un rendu conditionnel : le paragraphe n'apparaît que si la description existe. Attention avec les nombres : {count && <span>Nouveau</span>} avec count égal à 0 affichera un zéro à l'écran, donc avec des nombres écris count > 0 &&. export default permet aux autres fichiers d'importer la carte sans accolades.

Ce que Claude a écrit : Post

Ouvre components/Post.tsx. L'interface PostProps a quatre champs obligatoires, dont un numérique :

interface PostProps {
  author: string;
  avatar: string;
  content: string;
  likes: number;
}

likes est de type number, parce que les J'aime sont un nombre que tu vas augmenter dans la leçon 2_3. Si Claude écrivait ici string, l'addition se changerait en collage de textes.

Le corps du composant a trois parties : l'en-tête avec l'avatar et l'auteur, le contenu, et le bouton J'aime :

export default function Post({ author, avatar, content, likes }: PostProps) {
  return (
    <article className="rounded-lg border border-gray-300 p-4">
      <div className="flex items-center gap-3">
        <div className="flex h-10 w-10 items-center justify-center rounded-full bg-gray-900 text-sm font-bold text-white">
          {avatar}
        </div>
        <h3 className="font-bold">{author}</h3>
      </div>
      <p className="mt-3">{content}</p>
      <button type="button" className="mt-3 text-sm text-gray-500">
        J&apos;aime : {likes}
      </button>
    </article>
  );
}

rounded-full fait d'un carré h-10 w-10 un cercle, et flex avec items-center et justify-center met les initiales au milieu. Le bouton ne fait encore rien : il affiche seulement le nombre venu des props, parce que les props sont en lecture seule. Pour que le nombre change au clic, il faudra l'état de la leçon 2_3.

Les empreintes du sceau sur le fil et sur le profil

En haut de app/feed/page.tsx est arrivée la ligne import Post from "@/components/Post";. @/ est l'alias de la leçon 1_2, c'est-à-dire le dossier principal du projet, donc l'import s'écrit pareil depuis chaque page. La liste de posts ressemble maintenant à ceci :

{posts.map((post) => (
  <li key={post.id}>
    <Post author={post.author} avatar={post.avatar} content={post.content} likes={post.likes} />
    <Link href={`/post/${post.id}`} className="mt-1 inline-block text-sm text-blue-600 underline">
      Ouvrir le post
    </Link>
  </li>
))}

Les textes se passent entre guillemets ou entre accolades, et les nombres toujours entre accolades : likes={post.likes} ou likes={12}. L'écriture likes="12" passerait un texte, alors que l'interface exige un nombre, donc le build signalera une erreur de types. key se place sur l'élément que renvoie map, et vient de l'id fixe du post. L'index de map change quand un nouveau post saute en haut de la liste, il ne convient donc pas comme clé.

La page d'un post utilise le même Post sous le titre <h1>. Sur le profil, Claude a fait la même chose avec les cartes : il a ajouté un tableau following de trois pirates, et sous le titre <h2> « Pirates suivis » il le transforme en <PirateCard key={pirate.id} ... />. Seule Anne Bonny a une description, donc sur les deux autres cartes tu vérifieras que description && ne laisse vraiment pas de paragraphe vide. Les données descendent : la page détient les données, les passe comme props, et le composant les affiche.

Où le code s'exécute : Server et Client Components

Dans l'App Router, les pages, les layouts et les composants sont par défaut des Server Components. Next.js les rend sur le serveur, et le navigateur reçoit le résultat prêt, sans leur code JavaScript. En revanche, ils ne peuvent utiliser ni l'état, ni les effets, ni la gestion d'événements comme onClick, ni les API du navigateur comme localStorage.

Pour cela existent les Client Components. Le fichier commence par la directive "use client", et Next.js envoie son code au navigateur, où React branche les clics et l'état. La directive trace une frontière : tout ce qu'un tel fichier importe part aussi vers le navigateur.

Je te conseille une règle : par défaut des Server Components, et "use client" seulement dans de petits fichiers interactifs. Dans la leçon 2_3, ce sera le bouton J'aime seul, et non le post entier. Tu le vérifieras sans deviner. Demande à Claude : « Quels fichiers du projet sont des Client Components, et pourquoi ? », puis ouvre dans Cursor la recherche dans le projet (l'icône de loupe dans la barre de gauche) et tape use client. Après cette leçon, le résultat doit être vide.

La revue du capitaine

Avant de faire le commit, parcours le diff dans Source Control et vérifie :

  1. Un composant par fichier. components/Post.tsx exporte Post, et components/PirateCard.tsx exporte PirateCard : le nom du fichier est le nom du composant, donc dans un mois tu le retrouveras avec la recherche.
  2. Des props typées. likes est un number, et seule description est facultative.
  3. Des données venues des props. L'erreur typique de l'agent est un composant avec des données écrites en dur, par exemple <h3>Anne Bonny</h3> au lieu de {author}. Dans le fil, tu verras alors trois posts du même auteur, et dans le diff, le prénom dans le fichier du composant.
  4. Les limites de la demande. Aucun nouveau fichier ne contient "use client", et components/crew.tsx n'apparaît pas dans la liste des changements.

À la fin, npm run build, npm run lint et une promenade : /feed, /post/2 et /profile. Le fil et la page d'un post doivent se ressembler, parce que c'est le même sceau qui les imprime.

La composition en bref

Tu assembles les composants comme des briques : Post se tient dans un élément de liste, la liste dans une page, et la page dans le layout. Comment construire des composants qui acceptent n'importe quel contenu en leur centre, et comment passer tous les champs d'un objet d'un seul coup, la leçon 2_4 te le montrera. Ici, il te suffit de savoir commander un composant, le lire et vérifier ses props.

Étape suivante

Demande un commit avec une description du genre « Composants Post et PirateCard ». Puis fixe dans le règlement du navire la convention que tu viens de vérifier :

Ajoute à la partie « Messagerie de l'équipage » de @CLAUDE.md deux
lignes : composants dans components/, un par fichier, nom du fichier
comme nom du composant, props décrites par une interface ;
"use client" seulement dans de petits fichiers avec état
ou événements.

La prochaine fois, Claude respectera cette convention sans rappel, et toi, tu vérifieras dans le diff qu'il n'a ajouté que deux lignes. Dans la leçon 2_3, le bouton J'aime se mettra enfin à compter. Dans l'éditeur ci-dessous t'attendent les mêmes composants dans des fichiers séparés : supprime la description d'une carte ou change le nombre de J'aime, et regarde ce qui change.

Retiens : le sceau est unique, les empreintes sont nombreuses, et le capitaine vérifie que personne n'y a gravé en dur le nom d'un autre.

Code de cette leçon : App.jsx
// Fil et profil assemblés à partir des composants du dossier components/.
// Change les données des tableaux ci-dessous : les composants, eux, ne changent pas.
import Post from './components/Post';
import PirateCard from './components/PirateCard';

const posts = [
  { id: '1', author: 'Anne Bonny', avatar: 'AB', content: "Kraken aperçu près de l'île du Crâne. Cap à l'ouest.", likes: 12 },
  { id: '2', author: 'Jack Rackham', avatar: 'JR', content: "Gouvernail réparé. Qui m'aide avec les voiles ?", likes: 5 },
  { id: '3', author: 'Mary Read', avatar: 'MR', content: "Soupe de poisson au dîner. Premier arrivé, premier servi !", likes: 8 },
];

const following = [
  { id: '1', name: 'Anne Bonny', role: 'Capitaine', avatar: 'AB', description: 'La première à avoir vu le kraken.' },
  { id: '2', name: 'Jack Rackham', role: 'Timonier', avatar: 'JR' },
  { id: '3', name: 'Mary Read', role: 'Cuisinier', avatar: 'MR' },
];

export default function App() {
  return (
    <div className="min-h-screen bg-gray-50 p-6 text-gray-900">
      <h1 className="text-3xl font-bold">Le fil de l'équipage</h1>
      <ul className="mt-4 space-y-4">
        {posts.map((post) => (
          <li key={post.id}>
            <Post
              author={post.author}
              avatar={post.avatar}
              content={post.content}
              likes={post.likes}
            />
          </li>
        ))}
      </ul>

      <h2 className="mt-10 text-xl font-bold">Pirates suivis</h2>
      <div className="mt-4 grid grid-cols-1 gap-4 md:grid-cols-3">
        {following.map((pirate) => (
          <PirateCard
            key={pirate.id}
            name={pirate.name}
            role={pirate.role}
            avatar={pirate.avatar}
            description={pirate.description}
          />
        ))}
      </div>
    </div>
  );
}

Tu as repéré une erreur dans cette leçon ?

Teste tes connaissances

Réponds aux questions de cette leçon. Choisis une réponse pour voir tout de suite si elle est correcte.

  1. 1. Que sont les Props en React ?

  2. 2. Que retourne un composant React ?

Voici 2 des 8 questions de cette leçon. Réponds aux autres dans le jeu.

Tâches pratiques dans le jeu

  • Éditeur de code

    Écris un composant PirateCard (export default) avec les props name, role et avatar de type string. Décris les types des props dans une interface TypeScript, par exemple PirateCardProps. La carte affiche l'avatar, le nom dans un titre h3 et le rôle dans un paragraphe p.

  • Tri horizontal

    Ordonne les éléments qui transmettent une prop name au composant :

  • Clique dans l'ordre

    Clique sur les éléments pour utiliser le composant Post sans props :

  • Tri vertical

    Ordonne les lignes d'une définition simple de composant :

  • Éditeur de code

    Écris un composant Post façon Twitter (export default) : décris les props author et content de type string et likes de type number dans une interface TypeScript. Affiche l'auteur dans un titre h3, le contenu dans un paragraphe p et le nombre de likes dans un élément button. Stylise le post avec des classes Tailwind dans className, par exemple bg-white p-6 rounded-lg shadow.

  • Tri horizontal

    Ordonne les éléments qui commencent à mapper le tableau pirates :

  • Tri vertical

    Ordonne les lignes qui affichent une liste de pirates avec map() :

  • Clique dans l'ordre

    Clique sur les éléments pour importer le composant Post par l'alias @/ :

  • Tri vertical

    Ordonne comment les données atteignent un composant via les props :

  1. QuestionQuiz : Props
  2. QuestionCe que retourne un composant
  3. QuestionTyper les props avec une interface
  4. Exercice de codePratique : Composant de carte de pirate
  5. Remets dans l'ordreTransmettre une prop de type string
  6. QuestionUne prop optionnelle
  7. QuestionQuiz : Client vs Server Components
  8. QuestionLe type de composant par défaut
  9. Clique dans l'ordreUtiliser un composant en JSX
  10. Remets dans l'ordreStructure d'une définition de composant
  11. Exercice de codePratique : Composant Post
  12. QuestionLa prop key avec map()
  13. Remets dans l'ordreAppeler .map() sur une liste
  14. Remets dans l'ordreStructure du rendu d'une liste
  15. QuestionRendu conditionnel
  16. Clique dans l'ordreImport du composant Post
  17. Remets dans l'ordreFlux de données à travers les props

Articles utiles