Accueil › CSS & mise en page › Déboguer une mise en page : une méthode, pas des essais
Déboguer une mise en page : une méthode, pas des essais
Frameworks et débogageavance
Une méthode en cinq étapes, qui remplace les essais successifs :
- Identifier la boîte fautive. Inspecteur, puis remonter les ancêtres jusqu'à celui qui a la mauvaise taille.
- Lire la valeur effective dans l'onglet Computed — pas ce qui est déclaré, ce qui s'applique.
- Trouver la règle gagnante : les DevTools barrent les règles perdantes et nomment le fichier.
- Formuler une hypothèse et la tester dans le navigateur avant de toucher au code.
- Corriger la cause, pas le symptôme.
Le diagnostic visuel immédiat :
* { outline: 1px solid rgb(255 0 0 / .3); }
outline ne modifie pas la mise en page, contrairement à border. À coller dans les DevTools : toutes les boîtes deviennent visibles, et le coupable saute aux yeux en quelques secondes.
Les trois symptômes et leur cause statistique :
| Symptôme | Cause n°1 |
|---|---|
| Débordement horizontal | min-width: 0 / minmax(0, 1fr) manquant |
| Le style ne s'applique pas | mauvais _ngcontent, ou règle plus spécifique |
| Rien ne défile | 1fr au lieu de minmax(0, 1fr), ou min-height manquant |
Les termes à connaître
- Contour de diagnostic
* { outline: 1px solid red }: rend visibles toutes les boîtes d'un coup.outlineplutôt queborder, car il n'affecte pas la mise en page.- Panneau Computed
L'onglet des DevTools qui montre la valeur effective d'une propriété et la règle qui l'a emporté. Il répond à « pourquoi cette valeur ? ».
- Badges grid / flex
Les marqueurs des DevTools à côté d'un conteneur. Ils affichent les lignes de grille, les numéros de piste et les zones nommées.
- Dichotomie
Supprimer la moitié du DOM ou des styles pour isoler la cause. La méthode la plus rapide quand l'inspection ne donne rien.
- Reproduction minimale
Reconstruire le problème en HTML et CSS purs, hors du framework. Neuf fois sur dix, la cause apparaît pendant la reconstruction.
- Débordement
Le symptôme le plus courant. Cause n°1 : un
min-width: 0manquant sur un élément flex ou une piste de grille.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.