Formations — 1 037 leçons en français

Accueil › CSS & mise en page › Pourquoi ça déborde, et comment le diagnostiquer

Pourquoi ça déborde, et comment le diagnostiquer

Le flux et le modèle de boîtedebutant

Un débordement a toujours la même origine : quelque chose refuse de rétrécir.

La cause n°1, dans une mise en page flex :

.rangee { display: flex; }
.titre  { flex: 1; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
/* et pourtant le texte déborde… */

Un élément flex a min-width: auto par défaut : il refuse d'être plus étroit que son contenu. La correction tient en une ligne :

.titre { min-width: 0; }        /* ✓ maintenant il peut rétrécir, et l'ellipse s'applique */

Retenez-la : elle résout une énorme proportion des débordements en Angular, notamment dans les listes et les barres d'outils.

Les autres coupables habituels :

img   { max-width: 100%; height: auto; }     /* image sans borne */
pre, code { overflow-x: auto; }               /* bloc de code */
.mot  { overflow-wrap: anywhere; }            /* URL ou identifiant très long */
table { display: block; overflow-x: auto; }   /* tableau plus large que l'écran */

La méthode de diagnostic, en deux secondes :

* { outline: 1px solid red; }

L'élément qui dépasse saute aux yeux. Remontez ensuite ses parents jusqu'à celui qui impose la largeur.

Et ce qu'il ne faut pas faire : overflow-x: hidden sur le body. Cela masque le symptôme, rend du contenu inaccessible et casse le zoom sur mobile.

Les termes à connaître

Débordement (*overflow*)

Un contenu plus large ou plus haut que sa boîte. Par défaut il dépasse visiblement ; sur l'axe horizontal de la page, il crée une barre de défilement latérale.

min-width: auto

La valeur par défaut d'un élément flex ou grid : il refuse de devenir plus étroit que son contenu. Cause n°1 des débordements dans une mise en page flex.

overflow: hidden / auto

hidden coupe ce qui dépasse (et masque le problème), auto ajoute une barre de défilement quand c'est nécessaire. Ni l'un ni l'autre ne corrige la cause.

text-overflow: ellipsis

Remplace le texte coupé par des points de suspension. Exige overflow: hidden et white-space: nowrap pour fonctionner sur une ligne.

overflow-wrap: anywhere

Autorise la coupure d'un mot trop long (URL, identifiant) qui ferait déborder son conteneur. Plus sûr que word-break: break-all, qui coupe partout.

Élément insécable

Un contenu qui refuse de rétrécir : une image sans max-width, un tableau, un <pre>, un mot très long. Il impose sa largeur à toute la chaîne de parents.

Lire l'explication détaillée et faire le quiz →

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.