Kurs vibe coding z Claude Code · Moduł 3: Klon Twittera

Skrzynia i ładunek: children i kompozycja komponentów

6 min czytania ·
W tej lekcji8

Oś liczy polubienia i przyjmuje nowe wpisy ale ma trzy drobne usterki. Link "Otwórz wpis" wisi pod ramką wpisu, a nie w niej, bo Post nie umie przyjąć niczego do środka. Ta sama ramka, czyli klasy rounded-lg border border-gray-300 p-4, jest przepisana w Post i w PirateCard, więc zaokrąglenie rogów zmieniałbyś w dwóch plikach. A strona osi i strona wpisu wypisują ręcznie cztery propsy z jednego obiektu: author={post.author}, avatar={post.avatar} i dalej.

Skrzynia nie pyta o ładunek

Z lekcji 2_2 znasz propsy: rodzic wpisuje je jak atrybuty, a komponent je czyta. Jest jeden prop, którego nie wpisujesz jako atrybutu: children. To wszystko, co rodzic umieści między znacznikiem otwierającym a zamykającym komponentu. Spotkałeś go już w lekcji 2_1: {children} w app/layout.tsx to miejsce, w które Next.js wkłada aktualną stronę.

Pomyśl o skrzyni na pokładzie. Skrzynia ma ściany, zamek i okucia, ale nie pyta, co do niej włożysz: o ładunku decyduje ten, kto pakuje. Komponent z children jest taką skrzynią. Składanie większych części interfejsu z małych komponentów, które przyjmują cudzą treść, nazywa się kompozycją.

Polecenie dla Claude Code

Dzisiejsze zadanie to refaktor, czyli zmiana budowy kodu bez zmiany tego, co widzi gracz. Wyjątek jest jeden i nazwany wprost: link trafia do ramki. Wszystkie decyzje stoją w poleceniu, więc wystarczy tryb Manual, jak w lekcji 2_2.

Polecenie dla Claude Code:

Refaktor komunikatora bez zmiany wyglądu. 1) Wydziel ramkę wpisu
i karty do components/Card.tsx: komponent Card z propsem children.
Użyj go w @components/Post.tsx i @components/PirateCard.tsx.
2) Post dostaje opcjonalny children, wstawiany pod przyciskiem
polubień. W @app/feed/page.tsx przenieś link "Otwórz wpis" do środka
Post. 3) W @app/feed/page.tsx i @app/post/[id]/page.tsx przekaż dane
wpisu przez {...post}. Bez "use client" w Card. Na koniec npm run build
i npm run lint, pokaż oba wyniki.

Polecenie dzieli pracę na trzy ponumerowane kroki, więc w diffie sprawdzisz każdy z osobna. Zdanie "bez zmiany wyglądu" to sprawdzian dla Ciebie: po zmianie oś ma wyglądać tak samo, z jedną różnicą, o którą prosiłeś.

Co napisał Claude: skrzynia

W Explorerze pojawił się nowy plik, wspólna skrzynia dla wpisów i kart załogi. Otwórz 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 to typ wszystkiego, co może stać w JSX między znacznikami: tekstu, liczby, elementu, innego komponentu, a nawet pustki. Karta rysuje tylko ramkę, a w środku wstawia {children}, nie wiedząc, czy niesie wpis, czy kartę pirata. Nie ma tu stanu ani zdarzeń, więc plik zostaje Server Component bez dyrektywy.

Co napisał Claude: wpis z miejscem na ładunek

Teraz components/Post.tsx. Interfejs propsów dostał dwa nowe znaki zapytania, czyli dwa nowe pola opcjonalne:

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

children? jest opcjonalny, bo strona wpisu i wpisy kapitana z formularza niczego do środka nie wkładają. Znak zapytania przy likes to pomysł Claude: zauważył, że Feed wpisuje likes={0} przy każdym wpisie kapitana, i zamienił to na wartość domyślną. Widać ją w argumentach funkcji:

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

Zapis likes = 0 to wartość domyślna: gdy rodzic nie przekaże propsa, komponent dostaje 0. Gdy przekaże, na przykład 12, wartość domyślna nie ma znaczenia. Dzięki temu Feed nie musi już pisać likes={0}, a typ number z lekcji 2_2 pilnuje dalej, żeby nikt nie podał tekstu.

Ciało komponentu zamiast własnego <article> używa teraz skrzyni:

<Card>
  {/* awatar, autor i godzina bez zmian */}
  <p className="mt-3">{content}</p>
  <LikeButton initialLikes={likes} />
  {children}
</Card>

Wszystko między <Card> a </Card> trafia do karty jako jej children. Pod przyciskiem polubień stoi {children} samego wpisu: miejsce na ładunek, który przyniesie strona. PirateCard przeszła tę samą przeróbkę: <article> z klasami ramki zamieniła się w <Card>, a środek karty nie zmienił się ani o literę.

Ładunek z zewnątrz i spread

Najciekawsza zmiana czeka w app/feed/page.tsx, w pętli map po wpisach załogi:

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

{...post} to spread propsów: zamiast wypisywać author={post.author}, avatar={post.avatar} i dalej, przekazujesz każde pole obiektu jako osobny prop. To ten sam operator ..., który w lekcji 2_3 kopiował tablicę wpisów. Post nie kończy się tu na />, tylko ma parę znaczników, a Link między nimi staje się jego children.

Wpis nadal nie wie nic o adresach: o tym, co leży w ramce, decyduje strona osi. Gdyby Post dostał prop href i podawał go w dół przez kolejne komponenty tylko po to, żeby dotarł do linku, byłoby to przekazywanie propsów w głąb, po angielsku props drilling. Kompozycja oszczędza tej sztafety. Strona wpisu skróciła się do <Post {...post} />, bez ładunku.

Czego tu nie potrzebujesz

W starszych poradnikach, a czasem w propozycjach Claude, zobaczysz cięższe wzorce: komponenty złożone, które dzielą stan przez kontekst (compound components), albo funkcję w propsie, która sama rysuje zawartość (render props). Rozwiązują problemy, których komunikator nie ma. Polecam prostą zasadę: jeśli Claude proponuje kontekst albo nowy wzorzec dla ramki z jedną treścią, zapytaj, jaki problem rozwiązuje, zanim się zgodzisz.

Przegląd kapitana

Otwórz /feed, /post/2 i /profile w przeglądarce, a potem diff w Source Control:

  1. Wygląd bez zmian. Ramki, kolory i odstępy są takie jak przed refaktorem, a jedyna różnica to link w ramce. Typowy błąd agenta przy refaktorze to zmiany "przy okazji": inne klasy, nowe nazwy propsów w kilku plikach. Każda linia diffu, która nie wynika z trzech kroków polecenia, to pytanie do Claude.
  2. Ładunek naprawdę ląduje. Jeśli Claude dopisze children do interfejsu, ale zapomni wstawić {children} w JSX, build przejdzie, a link po cichu zniknie z osi. Jedynym śladem będzie ostrzeżenie 'children' is defined but never used w wyniku npm run lint, dlatego czytasz cały wynik, a nie tylko ostatnią linię.
  3. Spread przekazuje wszystko. {...post} wysyła do Post także id, którego wpis nie używa. Tu to nieszkodliwe, bo Post wyciąga z propsów tylko swoje pola. Uważaj, gdy Claude rozkłada obiekt danych prosto na znacznik HTML, na przykład <article {...post}>: wtedy pola danych lądują w HTML jako atrybuty.
  4. Typ ładunku. children ma typ React.ReactNode. Gdyby Claude wpisał string, build zatrzyma się na błędzie Type 'Element' is not assignable to type 'string', bo Link jest elementem, a nie tekstem.

Następny krok

Gdy wszystko się zgadza, poproś o commit z opisem w rodzaju "Card z children, Post przez spread, link wpisu w ramce". Skrzynia przyda się od razu w kolejnym miejscu, bez zmiany jej kodu:

Na @app/profile/page.tsx pod akapitem z rolą dodaj kartę "O kapitanie"
z nagłówkiem h2 i dwoma zdaniami o Redbeardzie, zbudowaną z Card.
Nie zmieniaj components/Card.tsx. Uruchom npm run build.

Nagłówek <h2> przyjdzie do karty jako część ładunku. Jeśli Claude zechce dopisać do Card nowy prop title, zapytaj, po co: skrzynia, która przyjmuje dowolną treść, nie potrzebuje osobnej przegródki na tytuł. W edytorze poniżej czeka oś złożona z tych samych klocków: usuń {children} z wpisu albo pole likes z jednego obiektu i zobacz, co się zmieni.

Pamiętaj: skrzynia nie pyta o ładunek, a kapitan sprawdza, czy ładunek naprawdę trafił do środka.

Kod do tej lekcji: App.jsx
// Oś i profil złożone z klocków: Card to skrzynia, children to ładunek.
// Spróbuj: usuń {children} z components/Post.jsx albo pole likes z wpisu.
import Post from './components/Post';
import PirateCard from './components/PirateCard';

const posts = [
  { id: '1', author: 'Anne Bonny', avatar: 'AB', content: 'Kraken widziany przy Wyspie Czaszek. Płyniemy na zachód.', likes: 12 },
  { id: '2', author: 'Jack Rackham', avatar: 'JR', content: 'Ster naprawiony. Kto pomoże przy żaglach?', likes: 5 },
  // Bez pola likes: Post użyje wartości domyślnej 0
  { id: '3', author: 'Mary Read', avatar: 'MR', content: 'Na kolację zupa rybna. Kto pierwszy, ten lepszy!' },
];

const following = [
  { id: '1', name: 'Anne Bonny', role: 'Kapitan', avatar: 'AB', description: 'Pierwsza zauważyła krakena.' },
  { id: '2', name: 'Jack Rackham', role: 'Sternik', 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">Oś załogi</h1>
      <ul className="mt-4 space-y-4">
        {posts.map((post) => (
          <li key={post.id}>
            {/* Spread: każde pole obiektu post idzie jako osobny prop */}
            <Post {...post}>
              {/* Ładunek: wszystko między znacznikami trafia do children */}
              <a href={'#/post/' + post.id} className="mt-2 block text-sm text-blue-600 underline">
                Otwórz wpis
              </a>
            </Post>
          </li>
        ))}
      </ul>

      <h2 className="mt-10 text-xl font-bold">Obserwowani piraci</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>
  );
}

Widzisz błąd w tej lekcji?

Sprawdź się

Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.

  1. 1. Czym jest prop children w komponencie Post?

  2. 2. Obiekt post ma pola id, author, avatar, content i likes. Co trafi do komponentu przy zapisie <Post {...post} />?

To 2 z 3 pytań do tej lekcji. Pozostałe rozwiążesz w grze.

Zadania praktyczne w grze

  • Układanie w poziomie

    Ułóż tokeny przekazania wszystkich pól wpisu do komponentu Post:

  1. PytanieProp children
  2. PytanieSpread propsów
  3. Ułóż w kolejnościSpread propsów w JSX
  4. PytanieDomyślna wartość propsa

Przydatne artykuły