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

Le coffre et la cargaison : children et composition de composants

8 min de lecture ·
Dans cette leçon8

Le fil compte les J'aime et accepte de nouveaux posts mais il a trois petits défauts. Le lien « Ouvrir le post » pend sous le cadre du post et non dedans, parce que Post ne sait rien accueillir à l'intérieur. Le même cadre, c'est-à-dire les classes rounded-lg border border-gray-300 p-4, est recopié dans Post et dans PirateCard, donc pour arrondir les coins autrement tu devrais modifier deux fichiers. Et la page du fil comme la page d'un post écrivent à la main quatre props tirées d'un seul objet : author={post.author}, avatar={post.avatar} et la suite.

Le coffre ne demande rien sur sa cargaison

Tu connais les props depuis la leçon 2_2 : le parent les écrit comme des attributs, et le composant les lit. Il existe une prop que tu n'écris pas comme un attribut : children. C'est tout ce que le parent place entre la balise ouvrante et la balise fermante du composant. Tu l'as déjà croisée dans la leçon 2_1 : {children} dans app/layout.tsx est l'endroit où Next.js glisse la page courante.

Pense à un coffre sur le pont. Le coffre a ses parois, sa serrure et ses ferrures, mais il ne demande pas ce que tu vas y ranger : la cargaison, c'est celui qui emballe qui la choisit. Un composant avec children est un tel coffre. Assembler de grandes parties d'interface à partir de petits composants qui accueillent le contenu d'autrui s'appelle la composition.

Demande pour Claude Code

Le travail du jour est un refactoring, c'est-à-dire un changement de la construction du code sans changer ce que voit le joueur. Il n'y a qu'une exception, nommée clairement : le lien entre dans le cadre. Toutes les décisions sont dans la demande, donc le mode Manual suffit, comme dans la leçon 2_2.

Demande pour Claude Code :

Refactoring de la messagerie sans changer l'apparence. 1) Extrais
le cadre des posts et des cartes dans components/Card.tsx : un
composant Card avec une prop children. Utilise-le dans
@components/Post.tsx et @components/PirateCard.tsx. 2) Post reçoit
un children facultatif, placé sous le bouton J'aime. Dans
@app/feed/page.tsx, déplace le lien « Ouvrir le post » à l'intérieur
de Post. 3) Dans @app/feed/page.tsx et @app/post/[id]/page.tsx,
passe les données du post avec {...post}. Pas de "use client" dans
Card. À la fin, lance npm run build et npm run lint, et montre les
deux résultats.

La demande découpe le travail en trois étapes numérotées, donc tu vérifieras chacune séparément dans le diff. La phrase « sans changer l'apparence » est un test pour toi : après la modification, le fil doit avoir le même aspect, avec une seule différence, celle que tu as demandée.

Ce que Claude a écrit : le coffre

Un nouveau fichier est apparu dans l'Explorateur, un coffre commun pour les posts et les cartes de l'équipage. Ouvre components/Card.tsx :

interface CardProps {
  children: React.ReactNode;
}

export default function Card({ children }: CardProps) {
  return <article className="rounded-lg border border-gray-300 p-4">{children}</article>;
}

React.ReactNode est le type de tout ce qui peut se trouver en JSX entre deux balises : un texte, un nombre, un élément, un autre composant, et même un vide. La carte ne dessine que le cadre et place {children} au milieu, sans savoir si elle porte un post ou une carte de pirate. Il n'y a ni état ni événement, donc le fichier reste un Server Component, sans directive.

Ce que Claude a écrit : un post avec une place pour la cargaison

Passons à components/Post.tsx. L'interface des props a reçu deux nouveaux points d'interrogation, donc deux nouveaux champs facultatifs :

interface PostProps {
  author: string;
  avatar: string;
  content: string;
  likes?: number;
  time?: string;
  children?: React.ReactNode;
}

children? est facultatif, parce que la page d'un post et les posts du capitaine venus du formulaire ne mettent rien dedans. Le point d'interrogation sur likes est une idée de Claude : il a remarqué que Feed écrit likes={0} pour chaque post du capitaine, et il en a fait une valeur par défaut. On la voit dans les arguments de la fonction :

export default function Post({ author, avatar, content, likes = 0, time, children }: PostProps) {

L'écriture likes = 0 est une valeur par défaut : quand le parent ne passe pas la prop, le composant reçoit 0. Quand il la passe, par exemple 12, la valeur par défaut ne compte pas. Grâce à cela, Feed n'a plus besoin d'écrire likes={0}, et le type number de la leçon 2_2 continue de veiller à ce que personne ne passe un texte.

Au lieu de son propre <article>, le corps du composant utilise désormais le coffre :

<Card>
  {/* avatar, auteur et heure inchangés */}
  <p className="mt-3">{content}</p>
  <LikeButton initialLikes={likes} />
  {children}
</Card>

Tout ce qui se trouve entre <Card> et </Card> arrive dans la carte comme ses children. Sous le bouton J'aime se trouve le {children} du post lui-même : la place pour la cargaison que la page apportera. PirateCard a subi la même transformation : son <article> avec les classes du cadre est devenu un <Card>, et l'intérieur de la carte n'a pas changé d'une lettre.

La cargaison de l'extérieur et le spread

Le changement le plus intéressant se trouve dans app/feed/page.tsx, dans la boucle map sur les posts de l'équipage :

<Post {...post}>
  <Link href={`/post/${post.id}`} className="mt-2 block text-sm text-blue-600 underline">
    Ouvrir le post
  </Link>
</Post>

{...post} est le spread de props : au lieu d'écrire author={post.author}, avatar={post.avatar} et la suite, tu passes chaque champ de l'objet comme une prop séparée. C'est le même opérateur ... qui, dans la leçon 2_3, copiait le tableau de posts. Ici Post ne se termine pas par />, il a une paire de balises, et le Link placé entre elles devient ses children.

Le post ne sait toujours rien des adresses : ce qui se trouve dans le cadre, c'est la page du fil qui en décide. Si Post recevait une prop href et la passait vers le bas, composant après composant, uniquement pour qu'elle arrive jusqu'au lien, ce serait du passage de props en profondeur, en anglais props drilling. La composition t'épargne ce relais. La page d'un post s'est raccourcie en <Post {...post} />, sans cargaison.

Ce dont tu n'as pas besoin ici

Dans de vieux tutoriels, et parfois dans les propositions de Claude, tu verras des patterns plus lourds : des composants composés qui partagent un état par le contexte (compound components), ou une fonction passée en prop qui dessine elle-même le contenu (render props). Ils résolvent des problèmes que la messagerie n'a pas. Je te conseille une règle simple : si Claude propose un contexte ou un nouveau pattern pour un cadre qui contient un seul contenu, demande-lui quel problème il résout avant d'accepter.

La revue du capitaine

Ouvre /feed, /post/2 et /profile dans le navigateur, puis le diff dans Source Control :

  1. Apparence inchangée. Les cadres, les couleurs et les espaces sont ceux d'avant le refactoring, et la seule différence est le lien dans le cadre. L'erreur typique d'un agent pendant un refactoring, ce sont les changements « au passage » : d'autres classes, de nouveaux noms de props dans plusieurs fichiers. Chaque ligne du diff qui ne découle pas des trois étapes de la demande est une question à poser à Claude.
  2. La cargaison arrive vraiment. Si Claude ajoute children à l'interface mais oublie de placer {children} dans le JSX, le build passe et le lien disparaît en silence du fil. Le seul indice sera l'avertissement 'children' is defined but never used dans le résultat de npm run lint, c'est pourquoi tu lis tout le résultat et pas seulement la dernière ligne.
  3. Le spread passe tout. {...post} envoie aussi à Post l'id, dont le post ne se sert pas. Ici c'est sans danger, car Post n'extrait des props que ses propres champs. Fais attention quand Claude déploie un objet de données directement sur une balise HTML, par exemple <article {...post}> : les champs de données se retrouvent alors dans le HTML comme attributs.
  4. Le type de la cargaison. children a le type React.ReactNode. Si Claude écrivait string, le build s'arrêterait sur l'erreur Type 'Element' is not assignable to type 'string', car Link est un élément et non un texte.

Étape suivante

Quand tout concorde, demande un commit avec une description du genre « Card avec children, Post par spread, lien du post dans le cadre ». Le coffre servira tout de suite ailleurs, sans changer son code :

Dans @app/profile/page.tsx, sous le paragraphe du rôle, ajoute une
carte « À propos du capitaine » avec un titre h2 et deux phrases sur
Barbe-Rousse, construite avec Card. Ne modifie pas
components/Card.tsx. Lance npm run build.

Le titre <h2> arrivera dans la carte comme une partie de la cargaison. Si Claude veut ajouter à Card une nouvelle prop title, demande-lui pourquoi : un coffre qui accepte n'importe quel contenu n'a pas besoin d'un compartiment séparé pour le titre. Dans l'éditeur ci-dessous t'attend un fil assemblé à partir des mêmes briques : supprime {children} du post ou le champ likes d'un des objets, et regarde ce qui change.

Retiens : le coffre ne demande rien sur sa cargaison, et le capitaine vérifie que la cargaison est vraiment arrivée à l'intérieur.

Code de cette leçon : App.jsx
// Fil et profil assemblés à partir de briques : Card est le coffre, children la cargaison.
// Essaie : supprime {children} de components/Post.jsx ou le champ likes d'un post.
import Post from './components/Post';
import PirateCard from './components/PirateCard';

const posts = [
  { id: '1', author: 'Anne Bonny', avatar: 'AB', content: "Kraken vu près de l'île des Crânes. Cap à l'ouest.", likes: 12 },
  { id: '2', author: 'Jack Rackham', avatar: 'JR', content: 'Gouvernail réparé. Qui m’aide avec les voiles ?', likes: 5 },
  // Sans le champ likes : Post utilisera la valeur par défaut 0
  { id: '3', author: 'Mary Read', avatar: 'MR', content: 'Soupe de poisson pour le dîner. Premier arrivé, premier servi !' },
];

const following = [
  { id: '1', name: 'Anne Bonny', role: 'Capitaine', avatar: 'AB', description: 'La première à avoir repéré le kraken.' },
  { id: '2', name: 'Jack Rackham', role: 'Timonier', avatar: 'JR' },
];

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&apos;équipage</h1>
      <ul className="mt-4 space-y-4">
        {posts.map((post) => (
          <li key={post.id}>
            {/* Spread : chaque champ de l'objet post passe comme une prop séparée */}
            <Post {...post}>
              {/* Cargaison : tout ce qui est entre les balises arrive dans children */}
              <a href={'#/post/' + post.id} className="mt-2 block text-sm text-blue-600 underline">
                Ouvrir le post
              </a>
            </Post>
          </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-2">
        {following.map((pirate) => (
          <PirateCard key={pirate.id} {...pirate} />
        ))}
      </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. Qu'est-ce que la prop children dans le composant Post ?

  2. 2. L'objet post a les champs id, author, avatar, content et likes. Que reçoit le composant avec l'écriture <Post {...post} /> ?

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

Tâches pratiques dans le jeu

  • Tri horizontal

    Ordonne les éléments qui transmettent tous les champs du post au composant Post :

  1. QuestionLa prop children
  2. QuestionLe spread de props
  3. Remets dans l'ordreLe spread de props en JSX
  4. QuestionLa valeur par défaut d'une prop

Articles utiles