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.