Kurs vibe coding z Claude Code · Moduł 3: Klon Twittera
Pieczęć kapitana: komponenty Post i PirateCard
W tej lekcji9
Mapa tras stoi ale oś pokazuje na razie tylko autora i treść. Wpis ma dostać okrągły awatar i przycisk polubień, i to w dwóch miejscach: na osi i na stronie pojedynczego wpisu. Profil ma z kolei pokazać karty obserwowanych piratów. Gdyby każda strona trzymała własną kopię tego samego JSX, zmiana koloru przycisku polubień oznaczałaby poprawki w kilku plikach i kilka okazji do pomyłki.
Komponent: jedna pieczęć, wiele odcisków
React rozwiązuje ten problem komponentami. Komponent to funkcja, która zwraca JSX, czyli opis fragmentu interfejsu, a gdy nie ma nic do pokazania, zwraca null. Zwykłego obiektu z danymi, na przykład { name: "Redbeard" }, React nie narysuje. Nazwa komponentu zaczyna się wielką literą, dzięki czemu React odróżnia <Post /> (Twoją funkcję) od <div> (znacznika HTML).
Pomyśl o pieczęci kapitana: pieczęć jest jedna, a odcisków na listach może być dowolnie wiele. Dane, którymi różnią się odciski, przekazujesz przez props. Działają jak argumenty funkcji: rodzic wpisuje je jak atrybuty HTML, a komponent tylko je czyta. TypeScript opisuje je interfejsem z lekcji 1_4, więc literówka w nazwie propsa albo tekst zamiast liczby kończy się błędem przy buildzie, a nie pustą kartą u gracza.
Polecenie dla Claude Code
Zadanie dotyka pięciu plików, ale nie zostawia decyzji do podjęcia: nazwy, propsy i miejsca użycia są w poleceniu. Wystarczy tryb Manual, w którym zatwierdzasz każdą edycję. Gdy polecenie zostawia wybory, zacznij od /plan, jak w lekcji 2_1.
Polecenie dla Claude Code:
Wydziel z komunikatora dwa komponenty, każdy w osobnym pliku w components/.
Post: propsy author, avatar, content (teksty) i likes (liczba), z okrągłym
awatarem i przyciskiem polubień, który na razie tylko pokazuje liczbę.
Użyj go w @app/feed/page.tsx i w @app/post/[id]/page.tsx.
PirateCard: propsy name, role, avatar i opcjonalny description. Na
@app/profile/page.tsx pokaż pod akapitem z rolą listę trzech obserwowanych
piratów. Propsy opisz interfejsem w pliku komponentu. Bez "use client"
i bez stanu. Nie ruszaj components/crew.tsx, bo CrewCard należy do
landing page'a. Na koniec uruchom npm run build i npm run lint.Polecenie nazywa pliki, propsy z typami i miejsca użycia, a zakazy mówią, czego nie ruszać. Ostatnie zdanie żąda dowodu, a nie meldunku "gotowe".
Co napisał Claude: PirateCard
W Explorerze pojawiły się dwa nowe pliki w folderze components/. Otwórz components/PirateCard.tsx. Na górze stoi umowa o propsach:
interface PirateCardProps {
name: string;
role: string;
avatar: string;
description?: string;
}Trzy pola są wymagane, a znak zapytania w description? oznacza pole opcjonalne: rodzic może je pominąć. Interfejs nie zmienia działania karty w przeglądarce, bo typy znikają po kompilacji. Pilnuje tylko, żeby dane pasowały do umowy.
Pod interfejsem stoi sam komponent, wyeksportowany domyślnie:
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>
);
}Zapis { name, role, avatar, description } wyciąga propsy z obiektu, który dostaje funkcja, a w JSX każdą wartość wstawiasz w klamrach. {description && ...} to renderowanie warunkowe: akapit pojawia się tylko wtedy, gdy opis istnieje. Uważaj przy liczbach: {count && <span>Nowe</span>} przy count równym 0 wyświetli na ekranie zero, więc przy liczbach pisz count > 0 &&. export default pozwala innym plikom zaimportować kartę bez nawiasów klamrowych.
Co napisał Claude: Post
Otwórz components/Post.tsx. Interfejs PostProps ma cztery wymagane pola, w tym jedno liczbowe:
interface PostProps {
author: string;
avatar: string;
content: string;
likes: number;
}likes jest typu number, bo polubienia to liczba, którą w lekcji 2_3 będziesz zwiększać. Gdyby Claude zapisał tu string, dodawanie zamieniłoby się w sklejanie tekstu.
Ciało komponentu ma trzy części: nagłówek z awatarem i autorem, treść oraz przycisk polubień:
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">
Polubienia: {likes}
</button>
</article>
);
}rounded-full z kwadratu h-10 w-10 robi koło, a flex z items-center i justify-center stawia inicjały na środku. Przycisk jeszcze nic nie robi: liczbę z propsów tylko wyświetla, bo propsy są do odczytu. Żeby zmieniała się po kliknięciu, potrzebny będzie stan z lekcji 2_3.
Odciski pieczęci na osi i na profilu
Na górze app/feed/page.tsx doszła linia import Post from "@/components/Post";. @/ to alias z lekcji 1_2, czyli główny folder projektu, więc import wygląda tak samo z każdej strony. Lista wpisów wygląda teraz tak:
{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">
Otwórz wpis
</Link>
</li>
))}Teksty przekazujesz w cudzysłowie albo w klamrach, a liczby zawsze w klamrach: likes={post.likes} albo likes={12}. Zapis likes="12" przekazałby tekst, a interfejs wymaga liczby, więc build zgłosi błąd typów. key stoi na elemencie, który zwraca map, i pochodzi ze stałego id wpisu. Indeks z map zmienia się, gdy nowy wpis wskoczy na górę listy, więc nie nadaje się na klucz.
Strona wpisu używa tego samego Post pod nagłówkiem <h1>. Na profilu Claude zrobił to samo z kartami: dopisał tablicę following z trzema piratami, a pod nagłówkiem <h2> "Obserwowani piraci" mapuje ją na <PirateCard key={pirate.id} ... />. Tylko Anne Bonny ma opis, więc na dwóch pozostałych kartach sprawdzisz, czy description && naprawdę nie zostawia pustego akapitu. Dane płyną w dół: strona trzyma dane, przekazuje je jako propsy, a komponent je wyświetla.
Gdzie działa kod: Server i Client Components
W App Routerze strony, layouty i komponenty są domyślnie Server Components. Next.js renderuje je na serwerze, a do przeglądarki trafia gotowy wynik bez ich kodu JavaScript. Za to nie mogą używać stanu, efektów, obsługi zdarzeń, takiej jak onClick, ani API przeglądarki, takich jak localStorage.
Do tego służą Client Components. Plik zaczyna się od dyrektywy "use client", a Next.js wysyła jego kod do przeglądarki, gdzie React podpina kliknięcia i stan. Dyrektywa wyznacza granicę: wszystko, co taki plik importuje, też trafia do przeglądarki.
Polecam Ci jedną zasadę: domyślnie Server Components, a "use client" tylko w małych, interaktywnych plikach. W lekcji 2_3 będzie to sam przycisk polubień, a nie cały wpis. Sprawdzisz to bez zgadywania. Zapytaj Claude: "Które pliki w projekcie są Client Components i dlaczego?", a potem otwórz w Cursorze wyszukiwanie w projekcie (ikona lupy w lewym pasku) i wpisz use client. Po tej lekcji wynik ma być pusty.
Przegląd kapitana
Zanim zrobisz commit, przejdź diff w Source Control i sprawdź:
- Jeden komponent na plik.
components/Post.tsxeksportujePost, acomponents/PirateCard.tsxeksportujePirateCard: nazwa pliku jest nazwą komponentu, więc za miesiąc znajdziesz go wyszukiwarką. - Propsy z typami.
likestonumber, a opcjonalny jest tylkodescription. - Dane z propsów. Typowy błąd agenta to komponent z danymi wpisanymi na sztywno, na przykład
<h3>Anne Bonny</h3>zamiast{author}. Na osi zobaczysz wtedy trzy wpisy z tym samym autorem, a w diffie imię w pliku komponentu. - Granice polecenia. W żadnym nowym pliku nie ma
"use client", acomponents/crew.tsxnie pojawia się na liście zmian.
Na koniec npm run build, npm run lint i spacer: /feed, /post/2 i /profile. Oś i strona wpisu mają wyglądać tak samo, bo odbija je ta sama pieczęć.
Kompozycja w zarysie
Komponenty składasz jak klocki: Post stoi w elemencie listy, lista na stronie, a strona w layoucie. Jak budować komponenty, które przyjmują w środek dowolną treść, i jak przekazać wszystkie pola obiektu jednym zapisem, pokaże lekcja 2_4. Tutaj wystarczy, że umiesz zamówić komponent, przeczytać go i sprawdzić jego propsy.
Następny krok
Poproś o commit z opisem w rodzaju "Komponenty Post i PirateCard". Potem utrwal konwencję, którą właśnie sprawdziłeś, w regulaminie okrętu:
Dopisz do części "Komunikator załogi" w @CLAUDE.md dwie linie: komponenty
w components/, jeden na plik, nazwa pliku jak nazwa komponentu, propsy
opisane interfejsem; "use client" tylko w małych plikach ze stanem
albo zdarzeniami.Następnym razem Claude trafi w tę konwencję bez przypominania, a Ty sprawdzisz w diffie, czy dopisał tylko dwie linie. W lekcji 2_3 przycisk polubień w końcu zacznie liczyć. W edytorze poniżej czekają te same komponenty w osobnych plikach: usuń opis jednej karty albo zmień liczbę polubień i zobacz, co się zmieni.
Pamiętaj: pieczęć jest jedna, odcisków wiele, a kapitan sprawdza, czy ktoś nie wyrył w niej na sztywno cudzego imienia.
Kod do tej lekcji: App.jsx
// Oś i profil złożone z komponentów z folderu components/.
// Zmień dane w tablicach poniżej i zobacz, że komponenty się nie zmieniają.
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 },
{ id: '3', author: 'Mary Read', avatar: 'MR', content: 'Na kolację zupa rybna. Kto pierwszy, ten lepszy!', likes: 8 },
];
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' },
{ id: '3', name: 'Mary Read', role: 'Kucharz', 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">Oś załogi</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">Obserwowani piraci</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>
);
}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 są Props w React?
2. Co zwraca komponent React?
To 2 z 8 pytań do tej lekcji. Pozostałe rozwiążesz w grze.
Zadania praktyczne w grze
- Edytor kodu
Napisz komponent PirateCard (export default) z propsami name, role i avatar typu string. Typy propsów opisz w interfejsie TypeScript, np. PirateCardProps. Karta ma pokazać awatar, imię w nagłówku h3 i rolę w akapicie p.
- Układanie w poziomie
Ułóż tokeny przekazania propsa name do komponentu:
- Klikanie w kolejności
Klikaj tokeny by użyć komponentu Post bez propsów:
- Układanie w pionie
Uporządkuj linie definicji prostego komponentu:
- Edytor kodu
Napisz komponent Post (export default) w stylu Twittera: propsy author i content typu string oraz likes typu number opisz w interfejsie TypeScript. Pokaż autora w nagłówku h3, treść w akapicie p, a liczbę polubień w przycisku button. Nadaj postowi styl klasami Tailwind w className, np. bg-white p-6 rounded-lg shadow.
- Układanie w poziomie
Ułóż tokeny rozpoczęcia mapowania tablicy pirates:
- Układanie w pionie
Uporządkuj linie renderowania listy piratów przez map():
- Klikanie w kolejności
Klikaj tokeny, by zaimportować komponent Post przez alias @/:
- Układanie w pionie
Uporządkuj jak dane trafiają do komponentu przez props:
Zadania po tej lekcji
- PytanieQuiz: Props
- PytanieCo zwraca komponent
- PytanieTypowanie props interfejsem
- Zadanie z kodemPraktyka: Komponent karty pirata
- Ułóż w kolejnościPrzekazanie propsa string
- PytanieOpcjonalny prop
- PytanieQuiz: Client vs Server Components
- PytanieDomyślny typ komponentu
- Kliknij w kolejnościUżyj komponentu w JSX
- Ułóż w kolejnościStruktura definicji komponentu
- Zadanie z kodemPraktyka: Komponent Post
- PytanieProp key przy map()
- Ułóż w kolejnościWywołanie .map() na liście
- Ułóż w kolejnościStruktura renderowania listy
- PytanieRenderowanie warunkowe
- Kliknij w kolejnościImport komponentu Post
- Ułóż w kolejnościPrzepływ danych przez props