CSS overflow : afficher, rogner ou faire défiler le contenu
En CSS, overflow détermine ce qui arrive au contenu qui dépasse de sa boîte. Utilisez auto pour permettre le défilement lorsque c’est nécessaire. Pour rogner un décor, hidden autorise encore le défilement par script, tandis que clip l’empêche.
Quelle valeur de overflow choisir ?
| Valeur | Effet sur le contenu qui dépasse |
|---|---|
visible |
Reste visible au-delà de la boîte. C’est la valeur initiale. |
auto |
Peut défiler à l’intérieur de la boîte. |
scroll |
La boîte devient une zone de défilement. L’affichage des barres dépend de la plateforme et du navigateur. |
hidden |
Le contenu est rogné, mais un script peut encore le faire défiler. |
clip |
Le contenu est rogné et le défilement est bloqué, y compris en JavaScript. |
Spécification W3C des propriétés CSS de débordement
Comparer le défilement dans des boîtes identiques
Enregistrez le code complet en UTF-8 sous overflow-example.html, puis ouvrez-le dans le navigateur. Les trois boîtes de 72px de haut ont le même contenu.
<!doctype html>
<html lang="fr">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Comparer le défilement dans des boîtes identiques</title>
<style>
body { margin: 1rem; font: 1rem/1.5 system-ui, sans-serif; }
.box { height: 72px; max-width: 20rem; border: 1px solid #547399; }
.content { min-height: 180px; padding: .5rem; background: #edf5ff; }
.auto { overflow: auto; }
.hidden { overflow: hidden; }
.clip { overflow: clip; }
.box:focus-visible { outline: 2px solid #104da2; outline-offset: 2px; }
</style>
</head>
<body>
<p id="auto-label">overflow: auto</p>
<div class="box auto" tabindex="0" role="region" aria-labelledby="auto-label">
<div class="content">Contenu de test pour le défilement. Le texte et son fond clair occupent une zone plus haute que la boîte visible.</div>
</div>
<p>overflow: hidden</p>
<div class="box hidden"><div class="content">Contenu de test pour le défilement. Le texte et son fond clair occupent une zone plus haute que la boîte visible.</div></div>
<p>overflow: clip</p>
<div class="box clip"><div class="content">Contenu de test pour le défilement. Le texte et son fond clair occupent une zone plus haute que la boîte visible.</div></div>
<p>
<button type="button" id="move">Défiler de 50px</button>
<button type="button" id="reset">Réinitialiser</button>
</p>
<p id="result" role="status"></p>
<script>
const boxes = [...document.querySelectorAll(".box")];
const modes = ["auto", "hidden", "clip"];
const result = document.querySelector("#result");
function moveTo(top) {
boxes.forEach(box => { box.scrollTop = top; });
result.textContent = boxes.map((box, i) =>
modes[i] + ": " + box.scrollTop + " px"
).join(" / ");
}
document.querySelector("#move").addEventListener("click", () => moveTo(50));
document.querySelector("#reset").addEventListener("click", () => moveTo(0));
</script>
</body>
</html>
La première boîte défile à la molette ou au toucher. Cliquez sur Défiler de 50px pour obtenir auto: 50 px / hidden: 50 px / clip: 0 px. Réinitialiser ramène les trois positions à zéro.
Au clavier, utilisez Tab pour placer le focus sur la première boîte, puis les flèches pour défiler. Donnez à une vraie zone de défilement un nom descriptif et vérifiez que le clavier permet d’y entrer et d’en sortir.
Différence entre hidden et clip
hidden crée un conteneur de défilement. Modifier scrollTop ou placer le focus sur un descendant peut déplacer le contenu. Avec clip, le contenu reste fixe, car la boîte ne devient pas un conteneur de défilement.
Pour rogner un décor et englober les éléments flottants d’un bloc, associez overflow: clip à display: flow-root. clip seul ne crée pas de contexte indépendant de mise en forme de bloc. Vérifiez que les commandes et leurs indicateurs de focus restent visibles.
Régler les deux axes du débordement
Avec deux valeurs, la première correspond à overflow-x et la seconde à overflow-y. Par exemple, overflow: visible auto donne auto sur les deux axes.
Avec overflow: clip auto, la valeur horizontale calculée dépend du navigateur. Les anciennes règles la transforment en hidden. Les navigateurs qui gèrent le défilement sur un seul axe conservent clip. Vérifiez les deux valeurs calculées dans vos navigateurs cibles.
Documentation Chrome sur les conteneurs de défilement à un seul axe
Pour un défilement vertical, vérifiez que la hauteur est réellement limitée, par exemple par max-height. Un bloc sans limite peut s’agrandir avec son contenu. Sur l’axe horizontal, la largeur utilisée doit être inférieure à celle dont le contenu a besoin.
Quand la boîte ne défile pas ou élargit la page
Si une rangée Flex élargit toute la page, inspectez l’élément Flex qui entoure la boîte défilante. Sa largeur minimale liée au contenu peut l’empêcher de rétrécir. Essayez min-width: 0 sur cet élément et overflow-x: auto sur la boîte interne. Avec une colonne Flex, vérifiez plutôt l’effet de min-height: 0.
Règles W3C de taille minimale automatique des éléments Flex
Pour couper de longues URL ou chaînes en plusieurs lignes, consultez Débordement, retour à la ligne et points de suspension en CSS.



