Cours Vibe coding avec Claude Code · Module 7: Clone de LinkedIn
Tableau d'offres : filtres dans l'adresse et un seul modèle d'offre
Dans cette leçon6
Les annonces de Crew Connections se multiplient. Un pirate de Tortuga veut voir uniquement les contrats de son port, puis envoyer un lien à un camarade d'équipage pour qu'il voie la même liste. Des filtres gardés dans l'état d'un composant disparaissent au rechargement, et on ne peut les transmettre à personne. Le filtre fera donc partie de l'adresse : /jobs?type=contract&location=Tortuga. Dans la leçon 6_3, tu as fait ainsi avec une seule phrase dans le réseau de contacts ; ici s'ajoutent deux listes de choix.
Le deuxième sujet, c'est l'ordre sur le pont. L'offre a déjà son type JobPost de la leçon 6_2, sa carte JobCard et la liste des types de contrat jobTypes. Le tableau doit s'en servir, pas tout reconstruire.
Demande pour Claude Code :
Ajoute des filtres à la page /jobs : type de contrat (type), port
(location) et phrase (q) dans le titre, le navire ou la description,
tous dans l'adresse, p. ex. /jobs?type=contract&location=Tortuga.
Utilise le type JobPost, la liste jobTypes et le composant JobCard,
ne crée pas de nouveau modèle d'offre. Le filtrage en fonctions pures
dans lib/job-filters.ts : parseJobFilters (un type inconnu dans
l'adresse = pas de filtre) et filterJobs, sans distinction de casse ;
d'abord les tests. Formulaire via next/form. Ajoute trois offres aux
données de départ pour avoir de quoi filtrer. À la fin : tests, lint,
types et build.Avant d'accepter le plan, vérifie une chose : Claude ne crée-t-il pas une nouvelle interface Job à côté de JobPost ? C'est une erreur fréquente d'un agent qui reçoit la tâche "tableau d'offres" et part de zéro. Deux modèles de la même offre divergent vite : l'un connaît par exemple trois types de contrat, l'autre quatre, et personne ne sait lequel est le vrai.
Ce que Claude a écrit : les filtres depuis l'adresse
Ouvre lib/job-filters.ts dans Cursor. Le type JobFilters a un type facultatif (une valeur de JobType) et des textes location et q. SearchParams est la forme des paramètres d'adresse dans Next.js : chaque valeur est un texte, un tableau de textes (quand le paramètre se répète) ou absente. La première fonction traduit l'adresse en filtres, avec l'aide de deux petits assistants du même fichier :
export function parseJobFilters(params: SearchParams): JobFilters {
return {
type: isJobType(params.type) ? params.type : undefined,
location: text(params.location),
q: text(params.q),
};
}isJobType vérifie la valeur avec le même tableau jobTypes que le schéma Zod de la leçon 6_2, donc la liste des types de contrat vit toujours à un seul endroit. text renvoie un texte rogné, ou une chaîne vide quand le paramètre manque ou se répète. L'adresse, ce sont des données de l'utilisateur : quelqu'un peut taper ?type=pirate-a-mi-temps, et la page ne doit ni planter ni afficher une liste vide. Une valeur inconnue veut simplement dire "pas de filtre".
Ce que Claude a écrit : un résultat calculé à partir de la liste complète
La seconde fonction, dans le même fichier, renvoie les offres qui correspondent à tous les filtres posés en même temps :
const lower = (value: string) => value.toLocaleLowerCase("fr-FR");
export function filterJobs(jobs: JobPost[], filters: JobFilters): JobPost[] {
const phrase = lower(filters.q);
return jobs.filter(
(job) =>
(!filters.type || job.type === filters.type) &&
(!filters.location || lower(job.location) === lower(filters.location)) &&
(!phrase || lower(`${job.title} ${job.company} ${job.description}`).includes(phrase)),
);
}Chaque ligne est un filtre, et un filtre vide laisse tout passer. filter crée un nouveau tableau, donc la liste complète ne change pas, et tu recalcules le résultat à chaque fois. Il n'y a ni état séparé avec les offres filtrées, ni useEffect pour le synchroniser : une seule vérité, dont tout découle. toLocaleLowerCase("fr-FR") transforme aussi "É" en "é", comme dans la recherche de contacts. Les tests de lib/job-filters.test.ts vérifient des cas comme celui-ci :
it("combine les filtres : contrats à Tortuga", () => {
expect(ids(filterJobs(jobs, parseJobFilters({ type: "contract", location: "tortuga" })))).toEqual(["j3"]);
});jobs est constitué de trois offres de test, et ids transforme le résultat en liste d'identifiants pour que la comparaison reste courte. À côté se trouvent les tests d'un type de contrat inconnu, de la phrase "ÉTOILE", qui trouve le navire "Étoile Filante", et de la liste complète, qui garde ses trois offres après le filtrage.
Ce que Claude a écrit : la page lit l'adresse
Ouvre app/jobs/page.tsx. C'est un Server Component, donc il filtre sur le serveur et le navigateur reçoit une liste prête :
export default async function JobsPage({ searchParams }: PageProps<"/jobs">) {
const filters = parseJobFilters(await searchParams);
const allJobs = await getJobs();
const jobs = filterJobs(allJobs, filters);
const locations = [...new Set(allJobs.map((job) => job.location))].toSorted((a, b) => a.localeCompare(b, "fr"));
// plus bas : <JobFilters filters={filters} locations={locations} />, le compteur et les cartes
}searchParams dans Next.js 16 est une promesse, donc la page l'attend avec await, comme dans les leçons 4_5 et 6_3. La liste des ports est construite à partir des offres, et Set supprime les doublons. Plus bas, la page affiche "Offres trouvées : 1 sur 5" et dessine chaque offre avec le même JobCard que dans la leçon 6_2. Regarde le résultat de npm run build : avant cette leçon, /jobs portait le signe ○, parce que le build avait rendu la liste une seule fois, et maintenant il porte ƒ, parce que la page lit l'adresse de chaque requête.
Ce que Claude a écrit : le formulaire qui change l'adresse
Les filtres sont dessinés par components/jobs/JobFilters.tsx. À la place d'un <form> ordinaire, on trouve ici le composant Form de next/form, qui transforme les champs en paramètres d'adresse à l'envoi (classes et étiquettes omises) :
<Form action="/jobs">
<input key={filters.q} id="q" name="q" defaultValue={filters.q} />
<select key={filters.location} id="location" name="location" defaultValue={filters.location}>
<option value="">Tous les ports</option>
{/* ports tirés des offres */}
</select>
{/* type de contrat : même schéma, options de jobTypes et libellés de lib/job-labels.ts */}
<button>Filtrer</button>
</Form>Après un clic sur Filtrer, Form passe à la nouvelle adresse sans recharger toute la page. Chez nous, après le choix de Tortuga et d'un contrat, l'adresse ressemblait à ceci : /jobs?q=&location=Tortuga&type=contract. Le champ vide arrive lui aussi dans l'adresse, et parseJobFilters le traite comme une absence de filtre. À côté du bouton se trouve un simple <Link href="/jobs"> avec l'inscription "Effacer les filtres". Le bouton Précédent du navigateur revient au filtre précédent, parce que chaque filtre est une adresse distincte dans l'historique.
La revue du capitaine
- Des champs qui se souviennent de l'ancienne adresse. L'erreur typique d'un agent, ce sont des champs sans
key. Nous l'avons vérifié : sanskey, après un clic sur "Effacer les filtres", la liste affichait 5 offres sur 5, mais les listes de choix gardaient "Tortuga" et "contrat", donc le "Filtrer" suivant rétablissait l'ancien filtre.defaultValuene joue que quand le champ est créé, et une navigation qui ne change que les paramètres d'adresse laisse les anciens champs en place. Unkeyavec la valeur de l'adresse recrée le champ. Tu le poses sur les champs, pas surForm. - Deux modèles d'offre. Cherche dans Cursor, dans tout le projet,
interface Jobettype Job. Le seul modèle d'offre doit êtreJobPostdanstypes/job.ts. - Des déchets dans l'adresse. Ouvre
/jobs?type=abc. Chez nous, la page a affiché les cinq offres, sans erreur et sans liste vide. - La casse. Ouvre
/jobs?location=tortuga. Chez nous, trois offres de Tortuga sont sorties, bien que dans les données le port commence par une majuscule.
Étape suivante
Quand la revue est passée, demande un commit, par exemple "Tableau d'offres avec filtres dans l'adresse". Lance le serveur de développement en arrière-plan comme dans la leçon 6_4, pour vérifier les adresses dans le navigateur pendant que la session reste libre. Puis un petit pas avec un test :
Ajoute un filtre de salaire minimum (?min=8000) : une offre sans
fourchette ne correspond pas quand le filtre est posé, et une valeur
qui n'est pas un nombre veut dire pas de filtre. D'abord les tests de
filterJobs, ensuite le code.Dans l'éditeur ci-dessous t'attend un tableau d'offres avec une fausse barre d'adresse. Pose un filtre, clique sur Précédent et observe l'adresse, puis désactive les champs avec key, efface les filtres et regarde ce qui reste dans les listes de choix.
Souviens-toi : un seul tableau, un seul modèle d'offre et une seule vérité, et l'adresse dans la barre est une carte qu'on a le droit de transmettre.
Code de cette leçon : App.jsx
// Tableau d’offres en miniature : les filtres vivent dans l’adresse, et la liste est calculée à partir de la liste complète.
// La barre du haut imite le navigateur : le formulaire change l’adresse, et la « page » en lit les filtres,
// comme app/jobs/page.tsx lit searchParams. Précédent revient à l’adresse précédente.
import { useState } from 'react';
const jobTypes = ['full-time', 'part-time', 'contract', 'temporary'];
const jobTypeLabels = { 'full-time': 'temps plein', 'part-time': 'temps partiel', contract: 'contrat', temporary: 'pour une traversée' };
const jobs = [
{ id: 'j5', title: 'Navigateur pour une traversée', company: 'Revanche de la Reine Anne', location: 'Tortuga', type: 'temporary', description: 'À travers les récifs jusqu’à Nassau et retour.' },
{ id: 'j2', title: 'Cartographe d’expédition', company: 'Revanche de la Reine Anne', location: 'Nassau', type: 'contract', description: 'Cartes du littoral et journal des relevés.' },
{ id: 'j3', title: 'Charpentier de marine', company: 'Étoile Filante', location: 'Tortuga', type: 'contract', description: 'Réparation de la coque après la tempête.' },
{ id: 'j1', title: 'Premier officier', company: 'Black Pearl', location: 'Tortuga', type: 'full-time', description: 'Quart de nuit dans les eaux des Caraïbes.' },
{ id: 'j4', title: 'Cuisinier de bord', company: 'Black Pearl', location: 'Port Royal', type: 'part-time', description: 'Trois repas par jour pour l’équipage.' },
];
const locations = [...new Set(jobs.map((job) => job.location))].sort((a, b) => a.localeCompare(b, 'fr'));
// L’adresse vient de l’utilisateur : un type de contrat inconnu veut dire « pas de filtre ».
function parseJobFilters(params) {
const type = params.get('type');
return {
type: jobTypes.includes(type) ? type : undefined,
location: (params.get('location') ?? '').trim(),
q: (params.get('q') ?? '').trim(),
};
}
const lower = (value) => value.toLocaleLowerCase('fr-FR');
function filterJobs(list, filters) {
const phrase = lower(filters.q);
return list.filter(
(job) =>
(!filters.type || job.type === filters.type) &&
(!filters.location || lower(job.location) === lower(filters.location)) &&
(!phrase || lower(job.title + ' ' + job.company + ' ' + job.description).includes(phrase))
);
}
function JobsPage({ search, navigate, keyed }) {
const filters = parseJobFilters(new URLSearchParams(search));
const found = filterJobs(jobs, filters);
const key = (value) => (keyed ? value : undefined);
// next/form fait la même chose : les champs du formulaire deviennent des paramètres de l’adresse.
const submit = (event) => {
event.preventDefault();
navigate('?' + new URLSearchParams(new FormData(event.currentTarget)).toString());
};
return (
<div className="space-y-3">
<form onSubmit={submit} className="grid gap-2 rounded-lg border border-gray-200 bg-white p-3 text-sm sm:grid-cols-3">
<label className="font-semibold">
Chercher
<input key={key(filters.q)} name="q" defaultValue={filters.q} placeholder="p. ex. cartographe" className="mt-1 w-full rounded-lg border border-gray-300 px-2 py-1 font-normal" />
</label>
<label className="font-semibold">
Port
<select key={key(filters.location)} name="location" defaultValue={filters.location} className="mt-1 w-full rounded-lg border border-gray-300 px-2 py-1 font-normal">
<option value="">Tous les ports</option>
{locations.map((location) => <option key={location} value={location}>{location}</option>)}
</select>
</label>
<label className="font-semibold">
Type de contrat
<select key={key(filters.type ?? '')} name="type" defaultValue={filters.type ?? ''} className="mt-1 w-full rounded-lg border border-gray-300 px-2 py-1 font-normal">
<option value="">Tous</option>
{jobTypes.map((type) => <option key={type} value={type}>{jobTypeLabels[type]}</option>)}
</select>
</label>
<div className="flex items-center gap-3 sm:col-span-3">
<button className="rounded-full bg-blue-600 px-4 py-1 font-semibold text-white">Filtrer</button>
<button type="button" onClick={() => navigate('')} className="text-blue-700 underline">Effacer les filtres</button>
</div>
</form>
<p className="text-sm text-gray-600">Offres trouvées : {found.length} sur {jobs.length}</p>
{found.map((job) => (
<article key={job.id} className="rounded-lg border border-gray-200 bg-white p-3">
<h2 className="font-bold text-blue-700">{job.title}</h2>
<p className="text-sm text-gray-600">{job.company} · {job.location} · {jobTypeLabels[job.type]}</p>
</article>
))}
</div>
);
}
export default function App() {
const [history, setHistory] = useState(['']);
const [keyed, setKeyed] = useState(true);
const search = history[history.length - 1];
const navigate = (next) => setHistory((current) => [...current, next]);
const back = () => setHistory((current) => (current.length > 1 ? current.slice(0, -1) : current));
return (
<div className="min-h-screen bg-gray-100 p-4 text-gray-900">
<div className="mx-auto max-w-2xl space-y-3">
<div className="flex items-center gap-2 rounded-lg border border-gray-200 bg-white p-2 text-sm">
<button onClick={back} disabled={history.length < 2} className="rounded border border-gray-300 px-2 disabled:opacity-40">Précédent</button>
<code className="flex-1 truncate rounded bg-gray-100 px-2 py-1">/jobs{search}</code>
</div>
<label className="flex items-center gap-2 text-sm">
<input type="checkbox" checked={keyed} onChange={(e) => setKeyed(e.target.checked)} />
Champs avec key (décoche pour voir l’erreur typique)
</label>
<JobsPage search={search} navigate={navigate} keyed={keyed} />
</div>
</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. Que montrera la page /jobs?type=abc ?
2. Comment la page /jobs choisit-elle les offres à afficher ?
Voici 2 des 10 questions de cette leçon. Réponds aux autres dans le jeu.
Tâches pratiques dans le jeu
- Tri horizontal
Ordonne sur une seule ligne l'adresse du tableau d'offres : /jobs?type=contract&location=Tortuga&q=charpentier
- Tri vertical
Ordonne ce qui se passe après un clic sur Filtrer :
- Tri horizontal
Ordonne sur une seule ligne le chemin du fichier du skill de la leçon 6_1 : .claude/skills/nouveau-formulaire/SKILL.md
- Tri vertical
Ordonne la vérification du chat que Claude fait avec un serveur en arrière-plan :
- Clique dans l'ordre
Ordonne le nettoyage de l'effet dans useChat : return () => source.close()
- Clique dans l'ordre
Ordonne la lecture des filtres dans la page /jobs : parseJobFilters(await searchParams)
Exercices après cette leçon
- QuestionQuiz : type de contrat inconnu dans l'adresse
- QuestionQuiz : filtrer les offres (filterJobs)
- Remets dans l'ordreTri : l'adresse avec filtres
- Remets dans l'ordreTri : de Filtrer à la liste d'offres
- QuestionQuiz : skill ou CLAUDE.md
- Remets dans l'ordreTri : chemin d'un skill
- QuestionQuiz : disable-model-invocation
- QuestionQuiz : à quoi sert Ctrl+B
- Remets dans l'ordreTri : vérification du chat avec un serveur en arrière-plan
- QuestionQuiz : travail en arrière-plan (/tasks)
- Clique dans l'ordreTri : nettoyer le flux dans le navigateur
- QuestionQuiz : cancel dans le flux côté serveur
- QuestionQuiz : expéditeur du message
- Clique dans l'ordreTri : filtres depuis l'adresse
- QuestionQuiz : filtres dans l'adresse
- QuestionQuiz : key sur un champ de filtre
- Projet à envoyerEnvoie Connexions d'équipage au mentor
- VidéoRésumé du module