Cours Vibe coding avec Claude Code · Module 4: Clone d'Instagram

Squelette de navire : états de chargement et squelette de la galerie

11 min de lecture ·
Dans cette leçon8

Pour l'instant, les photos de la galerie sont dans le fichier lib/photos.ts donc la page les a sous la main dès qu'elle est créée. Une vraie galerie les récupère dans une base de données ou sur un autre serveur, et cela prend du temps. Dans cette leçon, tu vas simuler un serveur lent, et Claude Code construira un squelette de galerie pour le temps de l'attente, puis ajoutera deux états que les agents oublient volontiers : l'erreur et le coffre vide.

Le problème : un lien mort et un écran vide

Une page qui attend des données n'a rien à montrer. Rechargée dans le navigateur, elle reste longtemps sans réponse, et après un clic sur un lien d'une autre page, on dirait que le clic n'a rien fait. La documentation de Next.js avertit que l'utilisateur a alors l'impression que l'application ne répond pas. L'équipage clique une deuxième fois, recharge, et l'attente recommence à zéro.

Le remède est un état de chargement, c'est-à-dire un aspect à part de la page pour le temps de l'attente. Le mieux est qu'il ait la forme du futur contenu. Le contour gris des vignettes à la place des photos s'appelle un squelette (en anglais skeleton) : on voit ce qui va apparaître et où, donc rien ne saute quand les données arrivent enfin. C'est comme le tracé d'un navire au chantier : le mât n'est pas encore là, mais on sait où il se dressera.

Demande pour Claude Code : un serveur lent et loading.tsx

La première étape touche quatre fichiers, mais chacun est simple, donc on peut se passer de plan. La demande dit où doit naître le retard, ce qu'il ne faut pas utiliser et quelle forme doit avoir le squelette :

Demande pour Claude Code :

Dans @lib/photos.ts, ajoute une fonction async getPhotos() qui attend 1,5 s
puis renvoie les photos. C'est un faux serveur lent pour l'apprentissage,
explique-le dans un commentaire. La page @app/gallery/page.tsx doit attendre
getPhotos() sur le serveur, sans "use client" et sans useEffect. Pour le temps
de l'attente, ajoute app/gallery/loading.tsx : un cercle gris à la place de
l'avatar, une barre à la place du titre et une grille de vignettes grises avec
animate-pulse dans un fichier à part, components/GallerySkeleton.tsx, avec les
mêmes colonnes et le même espacement que la grille de @components/Gallery.tsx.
Termine par npm run build et npm run lint.

L'interdiction de useEffect a une raison. Dans la leçon 2_3, l'effet s'exécutait dans le navigateur, mais une page de l'App Router est par défaut un Server Component et peut attendre elle-même les données sur le serveur avant d'envoyer le HTML. Les tutoriels plus anciens récupèrent les données dans un effet d'un composant client, et Claude prend parfois ce chemin par habitude. La page n'attend alors rien du tout, donc le squelette de loading.tsx ne s'affiche jamais.

Ce que Claude a écrit : le faux serveur

Ouvre lib/photos.ts dans Cursor. Sous le tableau des photos se trouve une nouvelle fonction :

// Pour l'apprentissage, on simule un serveur lent : 1,5 s d'attente.
// Quand les photos seront dans une base de données, il ne restera que la requête.
export async function getPhotos(): Promise<Photo[]> {
  await new Promise((resolve) => setTimeout(resolve, 1500));
  return photos;
}

async devant la fonction signifie qu'elle renvoie une promesse (Promise), c'est-à-dire un résultat qui arrivera plus tard. await demande d'attendre cette promesse, et new Promise avec setTimeout n'est qu'une pause de 1500 millisecondes. Le tableau photos n'a pas changé : il faut seulement l'attendre, comme la réponse d'un vrai serveur.

Dans app/gallery/page.tsx, le début du composant a changé :

export default async function GalleryPage() {
  const photos = await getPhotos();

Le composant de la page est devenu une fonction async et attend les photos avant de renvoyer quoi que ce soit. Seul un Server Component peut faire cela : il n'y a ici ni "use client", ni état, ni effets. L'en-tête et la grille en dessous sont restés comme dans la leçon 3_3.

Ce que Claude a écrit : le squelette et loading.tsx

Ouvre components/GallerySkeleton.tsx. C'est une liste de vignettes grises dans la même grille que les photos :

export default function GallerySkeleton() {
  return (
    <div role="status">
      <span className="sr-only">Chargement des photos du voyage…</span>
      <ul
        aria-hidden="true"
        className="grid grid-cols-1 gap-1 sm:grid-cols-2 md:grid-cols-3 lg:grid-cols-4"
      >
        {Array.from({ length: 8 }, (_, index) => (
          <li key={index} className="aspect-square animate-pulse bg-gray-200" />
        ))}
      </ul>
    </div>
  );
}

Array.from({ length: 8 }, ...) crée huit vignettes, et les classes de la grille sont les mêmes que dans Gallery.tsx, donc le squelette a autant de colonnes que la galerie sur chaque écran. aspect-square fait des carrés, bg-gray-200 donne la couleur grise, et animate-pulse atténue la vignette puis la rééclaire en boucle. Une clé tirée de l'index est correcte ici, même si tu l'évitais dans la leçon 2_8 : la liste de vignettes grises ne change jamais et ne se réordonne jamais.

Des vignettes grises ne disent rien à une personne dont le lecteur d'écran lit la page à voix haute, donc aria-hidden="true" les cache pour lui. À leur place, le lecteur lira la phrase avec la classe sr-only, invisible à l'écran, et role="status" lui demande de l'annoncer.

Le squelette de toute la page se trouve dans app/gallery/loading.tsx :

import GallerySkeleton from "@/components/GallerySkeleton";

export default function Loading() {
  return (
    <main className="mx-auto max-w-4xl p-4">
      <div className="mb-6 flex items-center gap-4">
        <div className="h-24 w-24 animate-pulse rounded-full bg-gray-200" />
        <div className="h-8 w-48 animate-pulse rounded bg-gray-200" />
      </div>
      <GallerySkeleton />
    </main>
  );
}

loading.tsx est un fichier spécial de Next.js, comme page.tsx. Personne ne l'importe : Next.js enveloppe lui-même la page du même dossier avec ce fichier et l'affiche tant que la page attend. D'après la documentation, il le fait avec <Suspense>, un composant de React sur lequel tu reviendras tout de suite. Recharge localhost:3000/gallery : pendant une seconde et demie, le cercle gris, la barre et les vignettes pulsent, puis la galerie apparaît.

Quatre états et Suspense plus près des données

Si tu regardes bien le squelette, tu verras du gaspillage : l'avatar et le titre sont connus dès le début, et ils attendent aussi. loading.tsx couvre toute la page d'un coup. <Suspense> seul offre un rideau plus étroit : tu l'enroules uniquement autour de la partie qui attend les données, et dans la prop fallback tu indiques quoi montrer à la place. La documentation de Next.js recommande justement <Suspense> près de l'endroit qui attend les données.

C'est aussi le bon moment pour les autres états. Chaque vue avec des données en a quatre : le chargement, l'erreur, le vide et le succès. Si on lui demande une "liste de photos", Claude fera sans doute le premier et le dernier, et omettra ceux du milieu, car personne ne les a demandés. C'est pourquoi la demande nomme les quatre :

Demande pour Claude Code :

/plan L'en-tête du profil n'a pas besoin des photos, donc il doit s'afficher
tout de suite. Déplace l'attente de getPhotos() dans un nouveau Server Component
components/PhotoGrid.tsx et enveloppe-le dans @app/gallery/page.tsx avec
Suspense et GallerySkeleton. Gère quatre états : chargement (le squelette),
liste vide (une invitation à ajouter la première photo), erreur
(app/gallery/error.tsx avec un bouton Réessayer, d'après la documentation de
Next.js dans node_modules/next/dist/docs) et succès. @components/Gallery.tsx
ne change pas. Termine chaque étape par npm run build et npm run lint.

Renvoyer vers la documentation dans node_modules a une raison. Le fichier AGENTS.md créé par l'assistant d'installation prévient Claude que cette version de Next.js a des changements qu'il ne connaît pas par ses données d'entraînement, et le fichier d'erreur a changé récemment. Dans le plan, cherche les quatre fichiers de la demande. Si Claude commence à transformer Gallery.tsx en Server Component, appuie sur Esc : les likes de la leçon 3_3 ont besoin d'un état, et l'état ne vit que dans un composant client.

Ce que Claude a écrit : Suspense, le vide et l'erreur

Ouvre app/gallery/page.tsx. La page n'attend plus rien, et sous l'en-tête on trouve :

<Suspense fallback={<GallerySkeleton />}>
  <PhotoGrid />
</Suspense>

Le serveur envoie tout de suite l'en-tête et le squelette du fallback, et quand PhotoGrid a fini d'attendre, il envoie la grille prête à la même place. Cet envoi de la page par morceaux s'appelle le streaming. loading.tsx peut rester : il couvrirait toute la page si elle devait un jour de nouveau attendre en entier.

L'attente s'est déplacée dans components/PhotoGrid.tsx :

export default async function PhotoGrid() {
  const photos = await getPhotos();

  if (photos.length === 0) {
    return (
      <p className="py-12 text-center text-gray-600">
        Le coffre est encore vide. Ajoute la première photo du voyage.
      </p>
    );
  }

  return <Gallery photos={photos} />;
}

C'est un composant serveur async, comme la page de la première étape. Il vérifie le vide seulement après await, donc il ne le confond jamais avec le chargement. Quand les photos sont là, il les confie au composant Gallery, et les likes et la fenêtre fonctionnent comme dans la leçon 3_3.

Le dernier état vit dans app/gallery/error.tsx :

"use client";

export default function GalleryError({
  retry,
}: {
  error: unknown;
  retry: () => void;
}) {
  return (
    <main className="mx-auto max-w-4xl p-4 text-center">
      <h2 className="text-xl font-bold">La tempête a retenu les photos</h2>
      <p className="my-2 text-gray-600">Impossible de récupérer la galerie.</p>
      <button
        type="button"
        onClick={() => retry()}
        className="rounded bg-gray-900 px-4 py-2 text-white"
      >
        Réessayer
      </button>
    </main>
  );
}

Quand quelque chose dans la route /gallery lève une erreur, Next.js affiche ce composant à la place de la page, avec l'en-tête, car error.tsx couvre tout le dossier de la route. D'après la documentation, le fichier d'erreur doit être un composant client, d'où "use client". retry() récupère les données et redessine la page de zéro : si la tempête est passée, la galerie revient à sa place.

La revue du capitaine

Lance npm run dev et vérifie :

  1. Le squelette a la forme de la galerie. Recharge la page et rétrécis la fenêtre pendant le chargement : les vignettes grises se rangent en quatre, trois, deux puis une colonne, comme le feront ensuite les photos. Si le squelette a d'autres classes de grille que Gallery.tsx, la page sautera au moment où les données arriveront.
  2. L'erreur s'affiche vraiment. Demande à Claude un throw new Error("Tempête") provisoire au début de getPhotos, recharge la page et regarde le message. En mode développement, Next.js ajoute dans un coin une pastille d'erreur ; c'est un indice pour toi, l'équipage ne la verra pas. Ensuite, annule la modification avec /rewind.
  3. retry, et non reset. C'est une erreur typique de l'agent. Les anciennes versions de Next.js ne donnaient au fichier d'erreur que la fonction reset, et Claude l'écrit souvent de mémoire :
export default function GalleryError({
  reset,
}: {
  error: Error & { digest?: string };
  reset: () => void;
}) {

TypeScript et le lint passent, le message s'affiche, le bouton a l'air de fonctionner. Pourtant la documentation dit que reset se contente d'effacer l'erreur et de redessiner la page, sans récupérer les données une nouvelle fois. Nous l'avons vérifié : une fois la tempête passée, le bouton avec reset montrait toujours le message, alors que celui avec retry ramenait la galerie. Dans le diff, cherche le mot retry.

  1. Le squelette seulement en mode développement. Lance npm run build et trouve dans le résultat la ligne /gallery. Elle est précédée d'un rond ○, que la légende décrit comme "prerendered as static content" : la page a été créée une seule fois, pendant le build, et la seconde et demie d'attente s'est écoulée alors, sur ton ordinateur. Après npm run start, tu ne verras pas le squelette, et de nouvelles photos de la base n'apparaîtraient qu'après un nouveau build. Avec npm run dev, la page est créée à chaque visite, c'est pourquoi le squelette y est visible. La recherche de la prochaine leçon va changer cela.

Étape suivante

Quand la revue est passée, demande un commit, par exemple "Galerie : squelette, état vide et page d'erreur". Puis une petite extension de la page d'erreur :

Dans @app/gallery/error.tsx, enregistre l'erreur dans la console du
navigateur avec useEffect et console.error, comme dans l'exemple de la
documentation de Next.js. Ne change rien d'autre que ce fichier.

Tu le vérifieras avec une nouvelle tempête provisoire : dans la console du navigateur, une entrée avec le message apparaîtra. En version de production, elle ne contiendra pourtant qu'un message général avec l'identifiant digest. La documentation explique que Next.js masque les détails des erreurs du serveur pour ne rien révéler de sensible ; tu trouveras le texte complet dans les journaux du serveur grâce à cet identifiant.

Dans l'éditeur ci-dessous, tu bascules entre les quatre états de la galerie et tu rejoues la seconde et demie de chargement. Constate que le squelette et les photos occupent la même place, puis fais les exercices.

À retenir : le squelette est le tracé du navire au chantier, et le capitaine commande à Claude Code les quatre états, car l'équipage verra chacun d'eux.

Code de cette leçon : App.jsx
// Quatre états de la galerie : chargement, erreur, vide et succès
// Dans le projet, ils viennent de loading.tsx, Suspense, error.tsx et PhotoGrid.
// Ici, tu les bascules avec des boutons pour comparer ce que voit l'équipage.
import { 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',
  },
  {
    id: 'vagues-ciel',
    src: 'https://images.unsplash.com/photo-1505118380757-91f5f5632de0?w=600',
    alt: 'Vagues turquoise sur une plage blanche vues du ciel',
  },
  {
    id: 'voilier-nuit',
    src: 'https://images.unsplash.com/photo-1534447677768-be436bb09401?w=600',
    alt: 'Petit voilier sur une mer calme sous un ciel étoilé',
  },
  {
    id: 'palmiers',
    src: 'https://images.unsplash.com/photo-1519046904884-53103b34b206?w=600',
    alt: 'Palmiers et parasol de paille sur une plage blanche',
  },
  {
    id: 'sentier',
    src: 'https://images.unsplash.com/photo-1500530855697-b586d89ba3ee?w=600',
    alt: 'Chemin entre des rochers rouges menant vers une montagne',
  },
  {
    id: 'recif',
    src: 'https://images.unsplash.com/photo-1544551763-46a013bb70d5?w=600',
    alt: 'Plongeur au milieu d’un banc de poissons jaunes près d’un récif',
  },
];

// La même grille dans le squelette et dans la galerie : rien ne saute
const gridClasses = 'grid grid-cols-2 gap-1 sm:grid-cols-3';

function GallerySkeleton() {
  return (
    <div role="status">
      <span className="sr-only">Chargement des photos du voyage…</span>
      <ul aria-hidden="true" className={gridClasses}>
        {Array.from({ length: 6 }, (_, index) => (
          <li key={index} className="aspect-square animate-pulse bg-gray-200" />
        ))}
      </ul>
    </div>
  );
}

function PhotoGrid({ items }) {
  return (
    <ul className={gridClasses}>
      {items.map((photo) => (
        <li key={photo.id} className="relative aspect-square bg-slate-800">
          <img
            src={photo.src}
            alt={photo.alt}
            className="absolute inset-0 h-full w-full object-cover"
          />
        </li>
      ))}
    </ul>
  );
}

const views = [
  ['loading', 'Chargement'],
  ['error', 'Erreur'],
  ['empty', 'Vide'],
  ['success', 'Succès'],
];

export default function App() {
  const [view, setView] = useState('success');

  // On simule un serveur lent : une seconde et demie de squelette, puis les photos
  const replay = () => {
    setView('loading');
    setTimeout(() => setView('success'), 1500);
  };

  return (
    <div className="min-h-screen bg-slate-100 p-4 text-slate-900">
      <h1 className="mb-1 text-2xl font-bold">Treasure Gallery</h1>
      <p className="mb-3 text-sm text-slate-600">Photos du voyage</p>

      <div className="mb-4 flex flex-wrap gap-2">
        {views.map(([id, label]) => (
          <button
            key={id}
            type="button"
            onClick={() => setView(id)}
            aria-pressed={view === id}
            className={view === id
              ? 'rounded bg-slate-900 px-3 py-1 text-sm text-white'
              : 'rounded bg-white px-3 py-1 text-sm'}
          >
            {label}
          </button>
        ))}
        <button
          type="button"
          onClick={replay}
          className="rounded bg-amber-500 px-3 py-1 text-sm font-semibold text-slate-900"
        >
          Rejouer le chargement (1,5 s)
        </button>
      </div>

      {view === 'loading' && <GallerySkeleton />}

      {view === 'error' && (
        <div className="py-8 text-center">
          <h2 className="text-xl font-bold">La tempête a retenu les photos</h2>
          <p className="my-2 text-slate-600">Impossible de récupérer la galerie.</p>
          <button
            type="button"
            onClick={replay}
            className="rounded bg-slate-900 px-4 py-2 text-white"
          >
            Réessayer
          </button>
        </div>
      )}

      {view === 'empty' && (
        <p className="py-12 text-center text-slate-600">
          Le coffre est encore vide. Ajoute la première photo du voyage.
        </p>
      )}

      {view === 'success' && <PhotoGrid items={photos} />}
    </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. 1. Que fait la classe animate-pulse sur les vignettes grises du squelette de la galerie ?

  2. 2. Le bouton Réessayer dans error.tsx se contente d'effacer l'erreur et de redessiner la page, sans récupérer à nouveau les photos. Que verras-tu après le clic, quand la tempête est déjà passée ?

Voici 2 des 5 questions de cette leçon. Réponds aux autres dans le jeu.

Tâches pratiques dans le jeu

  • Tri vertical

    Ordonne ce qui se passe après l'arrivée sur /gallery, quand la grille attend dans Suspense :

  • Clique dans l'ordre

    Clique sur les fragments dans l'ordre pour que la page attende les photos sur le serveur :

  1. QuestionQuiz : animate-pulse dans le squelette
  2. Remets dans l'ordreTri : le chargement de la galerie pas à pas
  3. QuestionQuiz : Le bouton qui ne récupère pas les données
  4. QuestionQuiz : L'état vide de la galerie
  5. Clique dans l'ordreClic : La page attend les photos
  6. QuestionQuiz : loading.tsx et Suspense
  7. QuestionQuiz : Le squelette après le build

Articles utiles