Cours Vibe coding avec Claude Code · Module 4: Clone d'Instagram
La fenêtre de la longue-vue : grille et aperçu de la photo à partir d'un croquis
Dans cette leçon8
La galerie a déjà ses photos mais sur téléphone trois colonnes donnent des vignettes grandes comme un timbre, et aucune photo ne peut être vue en grand format. Dans cette leçon, Claude Code va construire une grille qui s'adapte à l'écran et une fenêtre d'aperçu au-dessus de la page. Une telle fenêtre s'appelle une modale : tant qu'elle est ouverte, le reste de la page attend dessous. Ce que tu veux, tu le montreras à Claude par un dessin, pas par une longue description.
Le problème : une mise en page se décrit mal avec des mots
Essaie de décrire la fenêtre d'aperçu de façon que personne n'ait de doute : où se trouve l'auteur, où est la croix, si la légende est sous la photo ou à côté. Cela donne un long paragraphe, et Claude devinera quand même une partie à sa façon. Les bonnes pratiques de Claude Code conseillent dans ce cas : au lieu de décrire, montre. Dans la leçon 0_5, tu donnais un fichier avec @ et le résultat d'une commande. Aujourd'hui, tu donneras une image, c'est-à-dire la photo de ton croquis sur feuille.
Le croquis comme partie de la demande
Claude Code lit les images PNG, JPEG, GIF et WebP. La documentation cite trois façons de les lui donner : glisser le fichier dans la fenêtre de Claude Code, coller l'image depuis le presse-papiers avec Ctrl+V (sous Windows et dans WSL Alt+V), ou indiquer le chemin du fichier dans la demande. Après un collage, un repère [Image #1] apparaît dans la demande. Nous n'avons pas vérifié le collage dans le terminal de Cursor, c'est pourquoi dans le cours, comme dans la leçon 0_5, nous donnons le chemin. Cette méthode fonctionne dans tous les terminaux.
Transfère sur l'ordinateur la photo de la feuille de la leçon 3_1, enregistre-la en JPEG ou PNG et dépose-la dans le projet, dans un nouveau dossier croquis/, sous le nom galerie.jpg. Claude lira un fichier du dossier du projet sans demander d'autorisation, comme n'importe quel autre fichier du projet.
Souviens-toi seulement qu'un croquis montre un écran à un instant donné. Il ne dit pas combien de colonnes il faut sur téléphone, ce que fait la touche Escape, ni ce qui se passe avec le défilement de la page. Une bonne demande avec une image a donc deux parties : l'image dit à quoi ça ressemble, et le texte dit comment ça marche et dans quel fichier cela doit naître.
Demande pour Claude Code
Le changement touche trois fichiers, et le dessin peut se lire de plusieurs façons, donc tu commences par un plan. La première phrase demande à Claude de décrire ce qu'il voit sur le croquis. Tu vérifies ainsi qu'il a lu le dessin comme toi, avant qu'il écrive la moindre ligne de code.
Demande pour Claude Code :
/plan D'abord, décris en quelques phrases ce que tu vois sur le croquis
croquis/galerie.jpg. Ensuite planifie l'aperçu de la photo dans Treasure Gallery.
Déplace la grille de @app/gallery/page.tsx dans un nouveau Client Component
components/Gallery.tsx : 1 colonne sur téléphone, 2 dès sm, 3 dès md,
4 dès lg, espacement gap-1, chaque vignette est un bouton. Un clic ouvre
la fenêtre components/PhotoModal.tsx disposée comme sur le croquis : auteur, croix,
grande photo, légende. La fenêtre se ferme avec la croix, la touche Escape et un clic
sur le fond sombre, mais pas un clic sur la fenêtre elle-même. Sous la fenêtre ouverte,
la page ne défile pas, et après la fermeture elle défile comme avant. Termine
chaque étape par npm run build et npm run lint.Lis la description du croquis au début du plan. Si Claude s'est trompé sur l'endroit où se trouvent la légende ou la croix, corrige le plan avant de l'accepter, comme dans la leçon 1_6. Une correction dans le plan coûte une phrase, dans le code fini tout un tour.
Ce que Claude a écrit : la grille
Ouvre components/Gallery.tsx. Le fichier commence par "use client", car il garde un état, et l'état vit dans le navigateur (leçon 2_3). L'état est la photo choisie ou null quand la fenêtre est fermée :
const [selected, setSelected] = useState<Photo | null>(null);Claude a importé le type Photo depuis lib/photos.ts, donc la galerie et les données parlent la même langue. Sous l'état, la grille de la leçon 3_1 dans une nouvelle tenue : une liste dans laquelle chaque vignette est un bouton qui ouvre la fenêtre :
<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>La classe grid active la grille (CSS Grid), et les classes de colonnes se lisent à partir du plus petit écran, comme dans la leçon 1_3 : grid-cols-1 sans préfixe vaut partout, sm: dès 640 pixels donne deux colonnes, md: dès 768 en donne trois, et lg: dès 1024 en donne quatre. gap-1 est l'espacement entre les carreaux, le même sur tous les écrans.
Un bouton au lieu d'un <div> avec onClick a de l'importance : on atteint un bouton avec la touche Tab et on l'ouvre avec Entrée, et le lecteur d'écran lit son nom d'après le alt de la photo. sizes a changé lui aussi. Avec des conditions min-width, le navigateur prend la première qui correspond, donc la liste va du plus grand écran au plus petit. Sur lg, un carreau fait 224 pixels, car la page fait au plus 896 pixels et il y a quatre colonnes.
Sous la liste se trouve la fenêtre, dessinée seulement quand une photo est choisie :
{selected && (
<PhotoModal photo={selected} onClose={() => setSelected(null)} />
)}&& ne dessine la fenêtre que pour une photo choisie. La fermeture met null, et React retire alors PhotoModal de l'écran en entier, avec ses effets. Cette information servira tout de suite dans la revue.
Ce que Claude a écrit : la fenêtre
Ouvre components/PhotoModal.tsx. Le <div> extérieur est le fond sombre sur tout l'écran, l'intérieur est la fenêtre blanche :
<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()}
>
{/* auteur avec la croix, photo, légende */}
</div>
</div>fixed fixe le fond à la fenêtre du navigateur, inset-0 l'étire sur tout l'écran et z-50 le pose au-dessus du reste de la page. Un clic sur le fond appelle onClose. Un clic sur la fenêtre blanche y arriverait aussi, car l'événement remonte l'arbre des éléments, c'est pourquoi event.stopPropagation() l'arrête sur la fenêtre. role="dialog" et aria-modal="true" disent aux lecteurs d'écran qu'il s'agit d'une boîte de dialogue et que le reste de la page est inactif pendant ce temps. aria-labelledby désigne le titre avec l'auteur comme nom de la fenêtre.
Dans l'en-tête de la fenêtre se trouve la croix :
<button
type="button"
onClick={onClose}
aria-label="Fermer l'aperçu"
autoFocus
className="rounded px-2 text-2xl leading-none"
>
×
</button>Le signe × seul ne dit rien au lecteur d'écran, donc le nom du bouton vient de aria-label. autoFocus met le focus sur la croix dès l'ouverture, et une personne au clavier est tout de suite dans la fenêtre. La photo sous l'en-tête a fill et object-contain, pour qu'on la voie en entier.
Escape et blocage du défilement
Deux comportements de la demande sont des effets de bord, ils vivent donc dans useEffect de la leçon 2_3. Le premier écoute le clavier :
useEffect(() => {
const handleKeyDown = (event: KeyboardEvent) => {
if (event.key === "Escape") onClose();
};
window.addEventListener("keydown", handleKeyDown);
return () => window.removeEventListener("keydown", handleKeyDown);
}, [onClose]);À chaque touche pressée, la fonction vérifie event.key et ferme la fenêtre sur Escape. La fonction renvoyée par l'effet est le nettoyage : React l'appelle quand le composant disparaît de l'écran, et l'écouteur est alors retiré. Sans nettoyage, chaque ouverture ajouterait un écouteur de plus.
Le second effet bloque le défilement de la page sous la fenêtre :
useEffect(() => {
const previous = document.body.style.overflow;
document.body.style.overflow = "hidden";
return () => {
document.body.style.overflow = previous;
};
}, []);À l'ouverture, l'effet retient la valeur actuelle de overflow et la met à "hidden", donc la molette de la souris ne déplace pas la page en arrière-plan. Le nettoyage rétablit la valeur retenue quand la fenêtre disparaît de l'écran.
La revue du capitaine
Ouvre localhost:3000/gallery et parcours la fenêtre toi-même :
- Les colonnes. Rétrécis la fenêtre du navigateur et compte les colonnes : quatre, trois, deux, une. Si sur téléphone il y en a encore trois, la classe sans préfixe est
grid-cols-3au lieu degrid-cols-1. - Trois façons de fermer et une qui ne ferme pas. La croix, Escape et un clic sur le fond sombre ferment la fenêtre. Un clic sur la photo ou la légende ne doit pas la fermer.
- Le défilement après la fermeture. Ouvre la fenêtre, ferme-la et fais défiler la page avec la molette. C'est l'endroit de l'erreur typique de l'agent, un effet qui bloque le défilement mais ne nettoie pas :
useEffect(() => {
document.body.style.overflow = "hidden";
}, []);Le build et le lint passent, la fenêtre fonctionne, et après la fermeture la page reste immobile. PhotoModal a disparu avec son effet, et overflow: hidden est resté sur <body>. Dans le diff, cherche overflow sans return dans le même effet. D'anciens tutoriels rétablissent le défilement dans une branche else avec une prop isOpen, mais pour une fenêtre dessinée par && le composant disparaît avant que cette branche ait le temps de s'exécuter.
- Le clavier. Parcours les vignettes avec Tab, ouvre une photo avec Entrée et ferme avec Escape.
Le dernier contrôle est pour les yeux : le résultat à côté du croquis. Les bonnes pratiques de Claude Code placent une capture d'écran à côté de la maquette parmi les vérifications qui se réussissent ou s'échouent, comme un build ou un linter. Fais une capture de la fenêtre ouverte, enregistre-la sous croquis/resultat.png et décris seulement la différence :
Compare croquis/galerie.jpg avec croquis/resultat.png. Sur le croquis, l'auteur est
au-dessus de la photo, et sur le résultat en dessous. Corrige seulement cet ordre
dans @components/PhotoModal.tsx et ne change rien d'autre.Deux images et une phrase sur la différence en disent plus qu'un paragraphe sur toute la fenêtre, et la dernière phrase tient Claude éloigné du reste du fichier.
Étape suivante
Quand la revue est passée, demande un commit. Puis une petite extension :
Ajoute à la fenêtre d'aperçu des flèches "précédente" et "suivante". Après la dernière
photo, la suivante est la première, et avant la première, la dernière. Les touches
flèche gauche et flèche droite font la même chose.Dans le diff, cherche la division avec reste : l'indice de la photo suivante est (index + 1) % photos.length, et celui de la précédente (index - 1 + photos.length) % photos.length. L'opérateur % renvoie le reste de la division, donc après le dernier indice on revient à zéro, et ajouter photos.length en reculant protège d'un nombre négatif. Si Claude a au passage réécrit toute la grille, /rewind revient à l'état d'avant la demande.
Dans l'éditeur ci-dessous t'attend une grille avec une fenêtre d'aperçu : change la largeur de l'aperçu et compte les colonnes, ouvre une photo, ferme-la de trois façons et vérifie que la page défile de nouveau.
À retenir : le croquis dit à Claude à quoi la fenêtre ressemble, les mots disent comment elle marche, et toi, tu vérifies qu'une fois la fenêtre fermée, le navire navigue de nouveau.
Code de cette leçon : App.jsx
// Grille avec fenêtre d'aperçu : Escape, clic sur le fond et blocage du défilement
import { useEffect, useState } from 'react';
const photos = [
{
id: 'coucher-plage',
src: 'https://images.unsplash.com/photo-1507525428034-b723cf961d3e?w=600',
alt: 'Vagues sur une plage de sable au coucher du soleil',
author: 'Morgan',
caption: 'Ici, nous avons enterré le coffre',
},
{
id: 'vagues-ciel',
src: 'https://images.unsplash.com/photo-1505118380757-91f5f5632de0?w=600',
alt: 'Vagues turquoise sur une plage blanche vues du ciel',
author: 'Polly',
caption: 'La baie vue du nid-de-pie',
},
{
id: 'voilier-nuit',
src: 'https://images.unsplash.com/photo-1534447677768-be436bb09401?w=600',
alt: 'Petit voilier sur une mer calme sous un ciel étoilé',
author: 'Capitaine Barbe-Rousse',
caption: 'Quart de nuit',
},
{
id: 'palmiers',
src: 'https://images.unsplash.com/photo-1519046904884-53103b34b206?w=600',
alt: 'Palmiers et parasol de paille sur une plage blanche',
author: 'Capitaine Barbe-Rousse',
caption: 'Île de la carte',
},
{
id: 'sentier',
src: 'https://images.unsplash.com/photo-1500530855697-b586d89ba3ee?w=600',
alt: 'Chemin entre des rochers rouges menant vers une montagne',
author: 'Morgan',
caption: 'Sentier vers la cachette',
},
];
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="Fermer l'aperçu"
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 colonne sur téléphone, 2 dès sm, 3 dès md, 4 dès 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>
);
}Tu as repéré une erreur dans cette leçon ?
Teste tes connaissances
Réponds aux questions de cette leçon. Choisis une réponse pour voir tout de suite si elle est correcte.
1. Quelle classe Tailwind crée une grille avec 3 colonnes ?
2. Que fait la classe aspect-square dans Tailwind ?
Voici 2 des 8 questions de cette leçon. Réponds aux autres dans le jeu.
Tâches pratiques dans le jeu
- Clique dans l'ordre
Clique sur les fragments de la ligne d'écoute du clavier dans l'ordre pour que la touche Escape ferme la fenêtre :
- Tri horizontal
Ordonne les fragments de la ligne par laquelle l'effet retire l'écoute du clavier quand la fenêtre disparaît de l'écran :
- Tri vertical
Ordonne les préfixes de points de rupture Tailwind du plus petit au plus grand écran :
- Éditeur de code
Grille responsive
- Tri horizontal
Ordonne les fragments de la ligne par laquelle le nettoyage de l'effet rétablit le défilement de la page après la fermeture de la fenêtre :
- Clique dans l'ordre
Clique sur les fragments dans l'ordre pour que la fenêtre d'aperçu ne soit dessinée que lorsqu'une photo est choisie :
- Éditeur de code
Composant Modal
- Tri vertical
Ordonne les étapes de l'interaction d'un utilisateur avec la modale de photo agrandie :
Exercices après cette leçon
- QuestionQuiz : CSS Grid
- QuestionQuiz : aspect-square
- Clique dans l'ordreClic dans l'ordre : fermer la fenêtre avec Escape
- Remets dans l'ordreTri : le nettoyage de l'écoute du clavier
- Remets dans l'ordreTri : les points de rupture responsives
- Exercice de codePratique : Grille de galerie
- QuestionQuiz : gap dans la grille
- Remets dans l'ordreTri : rétablir le défilement
- QuestionQuiz : stopPropagation dans la fenêtre
- QuestionQuiz : le positionnement du fond de la fenêtre
- Clique dans l'ordreClic dans l'ordre : la fenêtre seulement pour une photo choisie
- QuestionQuiz : fermer avec une touche
- Exercice de codePratique : Modale simple
- Remets dans l'ordreTri : ouverture et fermeture d'une modale
- QuestionQuiz : la photo suivante dans la fenêtre
- QuestionQuiz : le croquis pour Claude Code