Kurs vibe coding z Claude Code · Moduł 4: Klon Instagrama

Okno w lunecie: siatka i podgląd zdjęcia ze szkicu

8 min czytania ·
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:

  1. 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-3 zamiast grid-cols-1.
  2. 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ąć.
  3. 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ć.

  1. 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. 1. Która klasa Tailwind tworzy grid z 3 kolumnami?

  2. 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:

  1. PytanieQuiz: CSS Grid
  2. PytanieQuiz: aspect-square
  3. Kliknij w kolejnościKlikanie: Zamykanie okna klawiszem Escape
  4. Ułóż w kolejnościSortowanie: Sprzątanie nasłuchu klawiatury
  5. Ułóż w kolejnościSortowanie: Responsywne breakpointy
  6. Zadanie z kodemPraktyka: Grid galerii
  7. PytanieQuiz: gap w siatce
  8. Ułóż w kolejnościSortowanie: Przywrócenie przewijania
  9. PytanieQuiz: stopPropagation w oknie
  10. PytanieQuiz: Pozycjonowanie tła okna
  11. Kliknij w kolejnościKlikanie: Okno tylko przy wybranym zdjęciu
  12. PytanieQuiz: Zamykanie klawiszem
  13. Zadanie z kodemPraktyka: Prosty modal
  14. Ułóż w kolejnościSortowanie: Otwieranie i zamykanie modala
  15. PytanieQuiz: Następne zdjęcie w oknie
  16. PytanieQuiz: Szkic dla Claude Code

Przydatne artykuły