Propriété CSSModèle de boîte

overflow

Décide quoi faire du contenu qui ne tient pas dans un élément.

Valeur initiale
visible
Héritée
Non
Animable
non
S’applique à
conteneurs de bloc, conteneurs flex et conteneurs grid
JavaScript
element.style.overflow = "auto"
Sur cette page

Exemple

#
CSS
.table-wrapper {
  overflow-x: auto;
}
Aperçu

Définition et utilisation

#

La propriété overflow définit le comportement du contenu qui dépasse des dimensions d’un élément. Par défaut (visible), il déborde à l’extérieur. Vous pouvez aussi le découper, afficher des barres de défilement en permanence, ou seulement quand elles sont nécessaires.

C’est un raccourci pour overflow-x et overflow-y. En indiquant deux valeurs, vous réglez séparément l’axe horizontal et l’axe vertical, par exemple un défilement horizontal uniquement pour un tableau large.

Les valeurs autres que visible et clip créent un nouveau conteneur de défilement. Cela a des effets secondaires : par exemple, un ancêtre avec overflow: hidden désactive position: sticky chez ses descendants.

Syntaxe

#
Syntaxe
overflow: visible | hidden | clip | scroll | auto (1 à 2 valeurs);

Valeurs

#
  • visible

    Le contenu dépasse de l’élément.
  • hidden

    L’excédent de contenu est découpé, mais reste accessible au défilement par script.
  • auto

    Une barre de défilement apparaît seulement quand le contenu ne tient pas.
  • scroll

    Les barres de défilement sont toujours visibles (selon le système).
  • clip

    Découpe sans créer de conteneur de défilement, donc ne casse pas position: sticky.

Valeurs en pratique

#

visible

Le contenu dépasse de l’élément.
.demo { overflow: visible; }

hidden

L’excédent de contenu est découpé, mais reste accessible au défilement par script.
.demo { overflow: hidden; }

auto

Une barre de défilement apparaît seulement quand le contenu ne tient pas.
.demo { overflow: auto; }

scroll

Les barres de défilement sont toujours visibles (selon le système).
.demo { overflow: scroll; }

clip

Découpe sans créer de conteneur de défilement, donc ne casse pas position: sticky.
.demo { overflow: clip; }

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Sur téléphone, enveloppez les tableaux larges dans un élément avec overflow-x: auto, plutôt que de compresser les colonnes.
  • Si position: sticky a cessé de fonctionner, cherchez un ancêtre avec overflow: hidden et remplacez-le par overflow: clip.

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.