Kurs vibe coding z Claude Code · Moduł 3: Klon Twittera
Skrzynia i ładunek: children i kompozycja komponentów
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:
- 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.
- Ładunek naprawdę ląduje. Jeśli Claude dopisze
childrendo 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 usedw wynikunpm run lint, dlatego czytasz cały wynik, a nie tylko ostatnią linię. - Spread przekazuje wszystko.
{...post}wysyła doPosttakżeid, którego wpis nie używa. Tu to nieszkodliwe, boPostwycią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. - Typ ładunku.
childrenma typReact.ReactNode. Gdyby Claude wpisałstring, build zatrzyma się na błędzieType 'Element' is not assignable to type 'string', boLinkjest 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. Czym jest prop children w komponencie Post?
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: