Kurs vibe coding z Claude Code · Moduł 4: Klon Instagrama
Okno w lunecie: siatka i podgląd zdjęcia ze szkicu
W tej lekcji8
Galeria ma już zdjęcia ale na telefonie trzy kolumny dają miniatury wielkości znaczka, a żadnego zdjęcia nie da się obejrzeć w dużym formacie. W tej lekcji Claude Code zbuduje siatkę, która dopasowuje się do ekranu, i okno podglądu nad stroną. Takie okno nazywa się modal: dopóki jest otwarte, reszta strony czeka pod nim. Czego chcesz, pokażesz Claude rysunkiem, a nie długim opisem.
Problem: układ trudno opisać słowami
Spróbuj opisać okno podglądu tak, żeby nikt nie miał wątpliwości: gdzie stoi autor, gdzie krzyżyk, czy podpis jest pod zdjęciem, czy obok niego. Wyjdzie długi akapit, a Claude i tak zgadnie część po swojemu. Dobre praktyki Claude Code radzą w takiej sytuacji: zamiast opisywać, podaj. W lekcji 0_5 podawałeś plik przez @ i wynik komendy. Dziś podasz obraz, czyli zdjęcie szkicu z kartki.
Szkic jako część polecenia
Claude Code czyta obrazy PNG, JPEG, GIF i WebP. Dokumentacja wymienia trzy sposoby, żeby mu je dać: przeciągnąć plik do okna Claude Code, wkleić obraz ze schowka skrótem Ctrl+V (na Windowsie i w WSL Alt+V) albo podać w poleceniu ścieżkę do pliku. Po wklejeniu w poleceniu pojawia się znacznik [Image #1]. Wklejania w terminalu Cursora nie sprawdzaliśmy, dlatego w kursie, tak jak w lekcji 0_5, podajemy ścieżkę. Ten sposób działa w każdym terminalu.
Zdjęcie kartki z lekcji 3_1 przerzuć na komputer, zapisz jako JPEG albo PNG i wrzuć do projektu, do nowego folderu szkice/, pod nazwą galeria.jpg. Plik z folderu projektu Claude odczyta bez pytania o zgodę, jak każdy inny plik projektu.
Pamiętaj tylko, że szkic pokazuje jeden ekran w jednej chwili. Nie powie, ile kolumn ma być na telefonie, co robi klawisz Escape ani co dzieje się z przewijaniem strony. Dobre polecenie z obrazem ma więc dwie części: obraz mówi, jak coś wygląda, a tekst mówi, jak działa i w którym pliku ma powstać.
Polecenie dla Claude Code
Zmiana dotyka trzech plików, a rysunek da się odczytać na kilka sposobów, więc zaczynasz od planu. Pierwsze zdanie każe Claude opisać, co widzi na szkicu. Tak sprawdzisz, czy przeczytał rysunek tak jak Ty, zanim napisze choć linię kodu.
Polecenie dla Claude Code:
/plan Najpierw opisz w kilku zdaniach, co widzisz na szkicu
szkice/galeria.jpg. Potem zaplanuj podgląd zdjęcia w Treasure Gallery.
Siatkę z @app/gallery/page.tsx przenieś do nowego Client Component
components/Gallery.tsx: 1 kolumna na telefonie, 2 od sm, 3 od md,
4 od lg, odstęp gap-1, każda miniatura to przycisk. Kliknięcie otwiera
okno components/PhotoModal.tsx ułożone jak na szkicu: autor, krzyżyk,
duże zdjęcie, podpis. Okno zamyka krzyżyk, klawisz Escape i kliknięcie
w ciemne tło, ale nie kliknięcie w samo okno. Pod otwartym oknem strona
się nie przewija, a po zamknięciu przewija się jak wcześniej. Każdy krok
kończ npm run build i npm run lint.Przeczytaj opis szkicu na początku planu. Jeśli Claude pomylił, gdzie stoi podpis albo krzyżyk, popraw plan przed akceptacją, jak w lekcji 1_6. Poprawka w planie kosztuje jedno zdanie, a w gotowym kodzie całą rundę.
Co napisał Claude: siatka
Otwórz components/Gallery.tsx. Plik zaczyna się od "use client", bo trzyma stan, a stan żyje w przeglądarce (lekcja 2_3). Stan to wybrane zdjęcie albo null, gdy okno jest zamknięte:
const [selected, setSelected] = useState<Photo | null>(null);Typ Photo Claude zaimportował z lib/photos.ts, więc galeria i dane mówią tym samym językiem. Pod stanem stoi siatka z lekcji 3_1 w nowym ubraniu: lista, w której każda miniatura jest przyciskiem otwierającym okno:
<ul className="grid grid-cols-1 gap-1 sm:grid-cols-2 md:grid-cols-3 lg:grid-cols-4">
{photos.map((photo, index) => (
<li key={photo.id}>
<button
type="button"
onClick={() => setSelected(photo)}
className="relative block aspect-square w-full cursor-pointer"
>
<Image
src={photo.src}
alt={photo.alt}
fill
sizes="(min-width: 1024px) 224px, (min-width: 768px) 33vw, (min-width: 640px) 50vw, 100vw"
loading={index < 3 ? "eager" : "lazy"}
className="object-cover"
/>
</button>
</li>
))}
</ul>Klasa grid włącza siatkę (CSS Grid), a klasy kolumn czytasz od najmniejszego ekranu, jak w lekcji 1_3: grid-cols-1 bez przedrostka obowiązuje wszędzie, sm: od 640 pikseli daje dwie kolumny, md: od 768 trzy, a lg: od 1024 cztery. gap-1 to odstęp między kafelkami, taki sam na każdym ekranie.
Przycisk zamiast <div> z onClick ma znaczenie: do przycisku dojdziesz klawiszem Tab i otworzysz go Enterem, a czytnik ekranu odczyta jego nazwę z alt zdjęcia. Zmieniło się też sizes. Przy warunkach min-width przeglądarka bierze pierwszy pasujący, więc lista idzie od największego ekranu. Na lg kafelek ma 224 piksele, bo strona ma najwyżej 896 pikseli, a kolumny są cztery.
Pod listą stoi okno, rysowane tylko wtedy, gdy jakieś zdjęcie jest wybrane:
{selected && (
<PhotoModal photo={selected} onClose={() => setSelected(null)} />
)}&& rysuje okno tylko przy wybranym zdjęciu. Zamknięcie ustawia null, a wtedy React usuwa PhotoModal z ekranu w całości, razem z jego efektami. Ta informacja przyda się za chwilę w przeglądzie.
Co napisał Claude: okno
Otwórz components/PhotoModal.tsx. Zewnętrzny <div> to ciemne tło na cały ekran, wewnętrzny to białe okno:
<div
className="fixed inset-0 z-50 flex items-center justify-center bg-black/80 p-4"
onClick={onClose}
>
<div
role="dialog"
aria-modal="true"
aria-labelledby="photo-modal-title"
className="w-full max-w-3xl overflow-hidden rounded-lg bg-white text-gray-900"
onClick={(event) => event.stopPropagation()}
>
{/* autor z krzyżykiem, zdjęcie, podpis */}
</div>
</div>fixed przypina tło do okna przeglądarki, inset-0 rozciąga je na cały ekran, a z-50 kładzie nad resztą strony. Kliknięcie tła woła onClose. Kliknięcie w białe okno też by tam dotarło, bo zdarzenie wędruje w górę drzewa elementów, dlatego event.stopPropagation() zatrzymuje je na oknie. role="dialog" i aria-modal="true" mówią czytnikom ekranu, że to okno dialogowe, a reszta strony jest na ten czas nieaktywna. aria-labelledby wskazuje nagłówek z autorem jako nazwę okna.
W nagłówku okna stoi krzyżyk:
<button
type="button"
onClick={onClose}
aria-label="Zamknij podgląd"
autoFocus
className="rounded px-2 text-2xl leading-none"
>
×
</button>Sam znak × nic nie mówi czytnikowi ekranu, więc nazwę przycisku daje aria-label. autoFocus przenosi fokus na krzyżyk zaraz po otwarciu, więc osoba z klawiaturą od razu jest w oknie. Zdjęcie pod nagłówkiem ma fill i object-contain, żeby było widać je w całości.
Escape i blokada przewijania
Dwa zachowania z polecenia to efekty uboczne, więc mieszkają w useEffect z lekcji 2_3. Pierwszy nasłuchuje klawiatury:
useEffect(() => {
const handleKeyDown = (event: KeyboardEvent) => {
if (event.key === "Escape") onClose();
};
window.addEventListener("keydown", handleKeyDown);
return () => window.removeEventListener("keydown", handleKeyDown);
}, [onClose]);Przy każdym naciśnięciu klawisza funkcja sprawdza event.key i przy Escape zamyka okno. Funkcja zwrócona z efektu to sprzątanie: React wywołuje ją, gdy komponent znika z ekranu, i wtedy nasłuch zostaje zdjęty. Bez sprzątania każde otwarcie dokładałoby kolejny nasłuch.
Drugi efekt blokuje przewijanie strony pod oknem:
useEffect(() => {
const previous = document.body.style.overflow;
document.body.style.overflow = "hidden";
return () => {
document.body.style.overflow = previous;
};
}, []);Przy otwarciu efekt zapamiętuje dotychczasową wartość overflow i ustawia "hidden", więc kółko myszy nie przesuwa strony w tle. Sprzątanie przywraca zapamiętaną wartość, gdy okno znika z ekranu.
Przegląd kapitana
Otwórz localhost:3000/gallery i przejdź przez okno sam:
- Kolumny. Zwężaj okno przeglądarki i licz kolumny: cztery, trzy, dwie, jedna. Jeśli na telefonie wciąż są trzy, klasa bez przedrostka to
grid-cols-3zamiastgrid-cols-1. - Trzy drogi zamknięcia i jedna, która nie zamyka. Krzyżyk, Escape i kliknięcie w ciemne tło zamykają okno. Kliknięcie w zdjęcie albo podpis nie może go zamknąć.
- Przewijanie po zamknięciu. Otwórz okno, zamknij je i przewiń stronę kółkiem myszy. To miejsce na typowy błąd agenta, czyli efekt, który blokuje przewijanie, ale nie sprząta:
useEffect(() => {
document.body.style.overflow = "hidden";
}, []);Build i lint przechodzą, okno działa, a po zamknięciu strona stoi w miejscu. PhotoModal zniknął razem ze swoim efektem, a overflow: hidden został na <body>. W diffie szukaj overflow bez return w tym samym efekcie. Starsze poradniki przywracają przewijanie w gałęzi else przy propsie isOpen, ale przy oknie rysowanym przez && komponent znika, zanim ta gałąź zdąży się wykonać.
- Klawiatura. Przejdź po miniaturach klawiszem Tab, otwórz zdjęcie Enterem i zamknij Escape.
Ostatni sprawdzian jest dla oczu: wynik obok szkicu. Dobre praktyki Claude Code liczą zrzut ekranu obok makiety do sprawdzianów, które da się zaliczyć albo oblać, tak jak build czy linter. Zrób zrzut otwartego okna, zapisz go jako szkice/wynik.png i opisz tylko różnicę:
Porównaj szkice/galeria.jpg ze szkice/wynik.png. Na szkicu autor stoi
nad zdjęciem, a na wyniku pod nim. Popraw tylko tę kolejność
w @components/PhotoModal.tsx i niczego więcej nie zmieniaj.Dwa obrazy i jedno zdanie o różnicy mówią więcej niż akapit o całym oknie, a ostatnie zdanie trzyma Claude z dala od reszty pliku.
Następny krok
Gdy przegląd przejdzie, poproś o commit. Potem małe rozszerzenie:
Dodaj do okna podglądu strzałki "poprzednie" i "następne". Po ostatnim
zdjęciu następne jest pierwsze, a przed pierwszym ostatnie. Klawisze
strzałek w lewo i w prawo działają tak samo.W diffie szukaj dzielenia z resztą: indeks następnego zdjęcia to (index + 1) % photos.length, a poprzedniego (index - 1 + photos.length) % photos.length. Operator % zwraca resztę z dzielenia, więc po ostatnim indeksie wraca zero, a dodanie photos.length przy cofaniu chroni przed liczbą ujemną. Jeśli Claude przy okazji przepisał całą siatkę, /rewind wraca do stanu sprzed polecenia.
W edytorze poniżej czeka siatka z oknem podglądu: zmień szerokość podglądu i policz kolumny, otwórz zdjęcie, zamknij je trzema sposobami i sprawdź, czy strona znów się przewija.
Zapamiętaj: szkic mówi Claude, jak okno wygląda, słowa mówią, jak działa, a Ty sprawdzasz, czy po zamknięciu okna okręt znów płynie.
Kod do tej lekcji: App.jsx
// Siatka z oknem podglądu: Escape, kliknięcie w tło i blokada przewijania
import { useEffect, useState } from 'react';
const photos = [
{
id: 'zachod-na-plazy',
src: 'https://images.unsplash.com/photo-1507525428034-b723cf961d3e?w=600',
alt: 'Fale na piaszczystej plaży o zachodzie słońca',
author: 'Morgan',
caption: 'Tu zakopaliśmy skrzynię',
},
{
id: 'fale-z-gory',
src: 'https://images.unsplash.com/photo-1505118380757-91f5f5632de0?w=600',
alt: 'Turkusowe fale przy białej plaży widziane z lotu ptaka',
author: 'Polly',
caption: 'Zatoka z bocianiego gniazda',
},
{
id: 'zaglowka-noca',
src: 'https://images.unsplash.com/photo-1534447677768-be436bb09401?w=600',
alt: 'Mała żaglówka na spokojnym morzu pod rozgwieżdżonym niebem',
author: 'Kapitan Redbeard',
caption: 'Nocna wachta',
},
{
id: 'palmy',
src: 'https://images.unsplash.com/photo-1519046904884-53103b34b206?w=600',
alt: 'Palmy i słomkowy parasol na białej plaży',
author: 'Kapitan Redbeard',
caption: 'Wyspa z mapy',
},
{
id: 'szlak',
src: 'https://images.unsplash.com/photo-1500530855697-b586d89ba3ee?w=600',
alt: 'Droga między czerwonymi skałami prowadząca w stronę góry',
author: 'Morgan',
caption: 'Szlak do kryjówki',
},
];
function PhotoModal({ photo, onClose }) {
useEffect(() => {
const handleKeyDown = (event) => {
if (event.key === 'Escape') onClose();
};
window.addEventListener('keydown', handleKeyDown);
return () => window.removeEventListener('keydown', handleKeyDown);
}, [onClose]);
useEffect(() => {
const previous = document.body.style.overflow;
document.body.style.overflow = 'hidden';
return () => {
document.body.style.overflow = previous;
};
}, []);
return (
<div
className="fixed inset-0 z-50 flex items-center justify-center bg-black/80 p-4"
onClick={onClose}
>
<div
role="dialog"
aria-modal="true"
aria-labelledby="photo-modal-title"
className="w-full max-w-md overflow-hidden rounded-lg bg-white text-gray-900"
onClick={(event) => event.stopPropagation()}
>
<div className="flex items-center justify-between p-3">
<h2 id="photo-modal-title" className="font-semibold">
{photo.author}
</h2>
<button
type="button"
onClick={onClose}
aria-label="Zamknij podgląd"
autoFocus
className="rounded px-2 text-2xl leading-none"
>
×
</button>
</div>
<div className="relative h-64 bg-black">
<img
src={photo.src}
alt={photo.alt}
className="absolute inset-0 h-full w-full object-contain"
/>
</div>
<p className="p-3 text-sm">{photo.caption}</p>
</div>
</div>
);
}
export default function App() {
const [selected, setSelected] = useState(null);
return (
<div className="min-h-screen bg-slate-100 p-4 text-slate-900">
<h1 className="mb-4 text-2xl font-bold">Treasure Gallery</h1>
{/* 1 kolumna na telefonie, 2 od sm, 3 od md, 4 od lg */}
<ul className="grid grid-cols-1 gap-1 sm:grid-cols-2 md:grid-cols-3 lg:grid-cols-4">
{photos.map((photo) => (
<li key={photo.id}>
<button
type="button"
onClick={() => setSelected(photo)}
className="relative block aspect-square w-full cursor-pointer"
>
<img
src={photo.src}
alt={photo.alt}
className="absolute inset-0 h-full w-full object-cover"
/>
</button>
</li>
))}
</ul>
{selected && (
<PhotoModal photo={selected} onClose={() => setSelected(null)} />
)}
</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. Która klasa Tailwind tworzy grid z 3 kolumnami?
2. Co robi klasa aspect-square w Tailwind?
To 2 z 8 pytań do tej lekcji. Pozostałe rozwiążesz w grze.
Zadania praktyczne w grze
- Klikanie w kolejności
Kliknij fragmenty linii z nasłuchu klawiatury w kolejności, aby klawisz Escape zamykał okno:
- Układanie w poziomie
Ułóż fragmenty linii, którą efekt zdejmuje nasłuch klawiatury, gdy okno znika z ekranu:
- Układanie w pionie
Uporządkuj prefiksy breakpointów Tailwind od najmniejszego do największego ekranu:
- Edytor kodu
Responsive grid
- Układanie w poziomie
Ułóż fragmenty linii, którą sprzątanie efektu przywraca przewijanie strony po zamknięciu okna:
- Klikanie w kolejności
Kliknij fragmenty w kolejności, aby okno podglądu rysowało się tylko wtedy, gdy jakieś zdjęcie jest wybrane:
- Edytor kodu
Modal component
- Układanie w pionie
Uporządkuj kroki interakcji użytkownika z modalem powiększonego zdjęcia:
Zadania po tej lekcji
- PytanieQuiz: CSS Grid
- PytanieQuiz: aspect-square
- Kliknij w kolejnościKlikanie: Zamykanie okna klawiszem Escape
- Ułóż w kolejnościSortowanie: Sprzątanie nasłuchu klawiatury
- Ułóż w kolejnościSortowanie: Responsywne breakpointy
- Zadanie z kodemPraktyka: Grid galerii
- PytanieQuiz: gap w siatce
- Ułóż w kolejnościSortowanie: Przywrócenie przewijania
- PytanieQuiz: stopPropagation w oknie
- PytanieQuiz: Pozycjonowanie tła okna
- Kliknij w kolejnościKlikanie: Okno tylko przy wybranym zdjęciu
- PytanieQuiz: Zamykanie klawiszem
- Zadanie z kodemPraktyka: Prosty modal
- Ułóż w kolejnościSortowanie: Otwieranie i zamykanie modala
- PytanieQuiz: Następne zdjęcie w oknie
- PytanieQuiz: Szkic dla Claude Code