CKTIS / CSS
scroll-behavior — scrollgedrag
De eigenschap scroll-behavior bepaalt of scrollen dat door navigatie of een API wordt gestart direct of vloeiend verloopt. De eigenschap stuurt direct scrollen door de gebruiker niet aan.
Versie: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntax
scroll-behavior: auto | smooth;scroll-behavior geldt voor scrollcontainers. De beginwaarde auto betekent direct scrollen; smooth betekent een beweging met een duur en verloop die door de browser worden bepaald. De eigenschap wordt niet overgeërfd en is niet animeerbaar.
De eigenschap geldt voor navigatie, scroll-API’s en scroll-snapbewerkingen die niet door de gebruiker zijn gestart. Direct scrollen met een gebaar of muiswiel verandert ze niet. Op html stuurt ze de viewport van de pagina aan; instellen op body draagt haar niet over aan die viewport. Browsers kunnen de eigenschap negeren.
In het voorbeeld maken overflow: auto en een beperkte hoogte een scrollcontainer. Een aanroep van scrollTo() met behavior: 'auto' gebruikt de berekende waarde van scroll-behavior en kan daardoor een vloeiende beweging starten. Dat is niet hetzelfde als CSS scroll-behavior: auto. Controleer de eindpositie, niet een vaste animatieduur.
Voorbeelden
<!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>Resultaat
After scrolling completes without interruption: panel.scrollTop === 240. No console output.
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.