CKTIS / CSS
scroll-behavior — comportement du défilement
La propriété scroll-behavior détermine si le défilement déclenché par la navigation ou une API est instantané ou fluide. Elle ne contrôle pas le défilement direct effectué par l’utilisateur.
Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
scroll-behavior: auto | smooth;scroll-behavior s’applique aux conteneurs défilants. La valeur initiale auto signifie un défilement instantané ; smooth signifie un mouvement dont la durée et le déroulement sont définis par le navigateur. Cette propriété n’est ni héritée ni animable.
Elle concerne la navigation, les API de défilement et les opérations de défilement par accrochage qui ne sont pas déclenchées par l’utilisateur. Elle ne modifie pas le défilement direct par geste ou à la molette. Sur html, elle contrôle la zone d’affichage de la page ; la définir sur body ne la transmet pas à cette zone. Les navigateurs peuvent l’ignorer.
Dans l’exemple, overflow: auto et une hauteur limitée créent un conteneur défilant. L’appel à scrollTo() avec behavior: 'auto' tient compte de la valeur calculée de scroll-behavior et peut donc déclencher un mouvement fluide. Ce n’est pas la même chose que CSS scroll-behavior: auto. Vérifiez la position finale, et non une durée d’animation fixe.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>scroll-behavior</title>
<style>
#panel {
height: 120px;
overflow: auto;
scroll-behavior: smooth;
border: 1px solid;
}
#content { height: 600px; }
</style>
<button id="go" type="button">Scroll to 240px</button>
<div id="panel" tabindex="0" aria-label="Scrollable example">
<div id="content">Scrollable content</div>
</div>
<script>
const panel = document.getElementById('panel');
document.getElementById('go').addEventListener('click', () => {
panel.scrollTo({ top: 240, behavior: 'auto' });
});
</script>
</html>Résultat
After scrolling completes without interruption: panel.scrollTop === 240. No console output.
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.