Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

 

Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.

La propriété overflow-y permet de définir les mécanismes à utiliser (rognage, ascenseurs, dépassement, etc.) lorsque le contenu dépasse des bords haut et bas de la boîte.

Valeur initialevisible
Applicabilitéles éléments de bloc non remplacés et les éléments en bloc en ligne et en bloc (inline-block)
Héritéenon
Médiavisuel
Valeur calculéecomme spécifié
Animablenon
Ordre canoniquel'ordre unique et non-ambigu défini par la grammaire formelle

Syntaxe

/* Le contenu n'est pas rogné */
overflow-y: visible;

/* Le contenu n'est pas rogné */
/* il n'y a pas d'ascenseurs  */
overflow-y: hidden;

/* Le contenu est rogné  */
/* il y a des ascenseurs */
overflow-y: scroll;

/* Le navigateur décide de */
/* la meilleure approche   */
overflow-y: auto;

/* Valeurs globales */
overflow-y: inherit;
overflow-y: initial;
overflow-y: unset;

Valeurs

visible
Le contenu n'est pas rogné. Il peut être affiché en dehors de la boîte de contenu malgré le manque d'espace.
hidden
Le contenu est rogné et aucun ascenseur vertical n'est affiché.
scroll
Le contenu est rogné et le navigateur affiche des barres de défilement (ascenseurs) dans tous les cas. Cela permet d'éviter d'avoir des barres qui apparaissent / disparaissent dans un environnement dynamique. Les imprimantes peuvent imprimer le contenu qui dépasse.
auto
Le comportement dépend de l'agent utilisateur. Les navigateurs de bureau comme Firefox peuvent afficher des barres de défilement si le contenu dépasse.

Syntaxe formelle

visible | hidden | scroll | auto

Exemples

HTML

<ul>
  <li><code>overflow-y:hidden</code> — cache le texte en dehors de la boîte
  <div id="div1">
    Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
    </div>
  </li>

  <li><code>overflow-y:scroll</code> — ajoute toujours un ascenseur
  <div id="div2">
    Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
    </div>
  </li>

  <li><code>overflow-y:visible</code> — affiche le texte en dehors de la boîte si besoin
  <div id="div3">
    Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
    </div>
  </li>

  <li><code>overflow-y:auto</code> — sur la plupart des navigateurs, cela sera équivalent à <code>scroll</code>
  <div id="div4">
    Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
    </div>
  </li>
</ul>
  

CSS

#div1, #div2, #div3,#div4 {
  border: 1px solid black;
  width:  250px;
  height: 100px;
}

#div1 {
  overflow-y: hidden;
  margin-bottom: 12px;
}

#div2 {
  overflow-y: scroll;
  margin-bottom: 12px;
}

#div3 {
  overflow-y: visible;
  margin-bottom: 120px;
}

#div4 {
  overflow-y: auto;
  margin-bottom: 120px;
}

Résultat

Spécifications

Spécification Statut Commentaires
CSS Overflow Module Level 3
La définition de 'overflow-y' dans cette spécification.
Version de travail  
CSS Basic Box Model
La définition de 'overflow-y' dans cette spécification.
Version de travail Définition initiale

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Support simple 1.0 1.5 (1.8) 5.0 [*] 9.5 3.0
Fonctionnalité Android Chrome pour Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support simple 1.0 (Oui) 1.0 (1.5) (Oui) (Oui) (Oui)

[*] IE8 a introduit la propriété -ms-overflow-y comme synonyme pour overflow-y. Cette version préfixée ne doit pas être utilisée.

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : SphinxKnight, Sebastianz, teoli, enogael, FredB, tregagnon, Delapouite, Igro
 Dernière mise à jour par : SphinxKnight,