KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen