Que fait Révision des Fondamentaux Frontend ?
« Un composant doit faire UNE chose correctement. Si vous le décrivez avec 'et', scindez-le. »
Quand l'activer
Activez cette compétence lors de la révision :
- Composants React/Vue/Svelte
- Logique de rendu UI
- Code de gestion d'état
- Décisions CSS/styling
- Routage côté client
Checklist de révision
Architecture des composants
- Responsabilité unique : Chaque composant fait-il UN seul travail ?
- Vérification de taille : Le composant fait-il moins de 200 lignes ?
- Nombre de props : Y a-t-il moins de 7 props ?
- Nommage : Pouvez-vous décrire le composant sans dire « et » ?
Gestion d'état
- Colocalisation : L'état est-il aussi proche que possible de son utilisation ?
- Levée d'état : L'état est-il partagé correctement entre frères via le parent ?
- Context vs Props : Le prop drilling est-il évité (max 3 niveaux) ?
- Données serveur : Les données serveur sont-elles gérées séparément (React Query/SWR) ?
Performances
- Memoization : Les calculs coûteux sont-ils encapsulés dans useMemo ?
- Callbacks : Les gestionnaires d'événements sont-ils encapsulés dans useCallback si nécessaire ?
- Re-rendus : Cela provoquera-t-il des re-rendus inutiles ?
- Chargement paresseux : Les composants lourds sont-ils découpés en code-splitting ?
Accessibilité
- HTML sémantique : Utilise-t-on les bons éléments (button vs div) ?
- ARIA : Les éléments interactifs sont-ils accessibles ?
- Clavier : Les utilisateurs peuvent-ils naviguer sans souris ?
Erreurs courantes (Anti-patrons)
1. Composants God
❌ UserDashboard.tsx (1000 lignes)
- récupère les données, gère l'état, rend l'UI, gère le routage
✅ Scindé en :
- UserDashboardPage.tsx (conteneur)
- UserStats.tsx (présentation)
- UserActivity.tsx (présentation)
- useUserData.ts (hook)
2. Logique dans le rendu
❌ return <div>{users.filter(u => u.active).map(u => ...)}</div>
✅ const activeUsers = useMemo(() => users.filter(u => u.active), [users]);
return <div>{activeUsers.map(u => ...)}</div>
3. Prop Drilling
❌ <App user={user}>
<Layout user={user}>
<Main user={user}>
<Widget user={user} />
✅ const user = useUser(); // dans Widget.tsx
4. Soupe de props booléennes
❌ <Button primary secondary large small disabled loading />
✅ <Button variant="primary" size="large" state="loading" />
Questions socratiques
Posez ces questions au junior plutôt que de donner des réponses :
- Architecture : « Quel est le SEUL rôle de ce composant ? »
- Scission : « Si je voulais utiliser uniquement la partie en-tête ailleurs, le pourriez-vous ? »
- État : « Qui a besoin de ces données ? Doivent-elles vivre ici ou plus haut ? »
- Performances : « Que se passe-t-il quand le parent se re-rend ? »
- Complexité : « Un nouveau développeur pourrait-il comprendre cela en 5 minutes ? »
Référence aux standards
Voir les patrons détaillés dans :
/standards/frontend/component-architecture.md
Drapeaux rouges à signaler
| Drapeau | Question à poser |
|---|---|
| Fichier > 200 lignes | « Pouvons-nous scinder cela en morceaux plus petits ? » |
| > 5 appels useState | « Une partie de cet état devrait-elle être levée ou combinée ? » |
| useEffect avec [] deps mais utilise des valeurs externes | « Manque-t-il des dépendances ? » |
| Manipulation directe du DOM | « Existe-t-il une façon React de faire cela ? » |
| Styles en ligne partout | « Devrions-nous utiliser une approche de style cohérente ? » |