Propriété CSSInteraction et divers

overscroll-behavior

Empêche toute la page de défiler après avoir atteint la fin d’un élément défilant.

Valeur initiale
auto
Héritée
Non
Animable
non
S’applique à
conteneurs de défilement
JavaScript
element.style.overscrollBehavior = "contain"
Sur cette page

Exemple

#
CSS
.chat-messages {
  max-height: 320px;
  overflow-y: auto;
  overscroll-behavior: contain;
}
Aperçu

Définition et utilisation

#

Lorsque vous faites défiler une liste à l’intérieur d’une page et que vous atteignez sa fin, le défilement suivant se transmet par défaut à la page située en dessous. Ce phénomène s’appelle le chaînage du défilement. La propriété overscroll-behavior: contain l’arrête.

Elle est utile dans les fenêtres de chat, les menus déroulants, les panneaux latéraux et les modales : faire défiler leur contenu ne déplace pas la page en arrière-plan.

La valeur none désactive en plus les effets de défilement au-delà du bord, comme le rebond sur iPhone ou l’actualisation de la page par un geste de tirage vers le bas sur Android.

Syntaxe

#
Syntaxe
overscroll-behavior: auto | contain | none (1 ou 2 valeurs);

Valeurs

#
  • auto

    Une fois la fin de la liste atteinte, le conteneur extérieur défile.
  • contain

    Le défilement s’arrête à la liste.
  • none

    Comme contain, sans effets de défilement au-delà du bord.

Valeurs en pratique

#

auto

Une fois la fin de la liste atteinte, le conteneur extérieur défile.
.demo { overscroll-behavior: auto; }

contain

Le défilement s’arrête à la liste.
.demo { overscroll-behavior: contain; }

none

Comme contain, sans effets de défilement au-delà du bord.
.demo { overscroll-behavior: none; }

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

#
  • Chaque panneau défilant dans une modale devrait avoir overscroll-behavior: contain.
  • Définir none sur l’élément body désactive l’actualisation de la page par geste dans les applications web.

Entrées associées

#

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