WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

scroll-behavior — Scrollverhalten

Die Eigenschaft scroll-behavior legt fest, ob durch Navigation oder eine API ausgelöstes Scrollen sofort oder sanft erfolgt. Direktes Scrollen durch Nutzerinnen und Nutzer wird dadurch nicht gesteuert.

Version: 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 gilt für Scrollcontainer. Der Anfangswert auto bedeutet sofortiges Scrollen; smooth bedeutet eine Bewegung, deren Dauer und Verlauf vom Browser festgelegt werden. Die Eigenschaft wird weder vererbt noch animiert.

Sie gilt für Navigation, Scroll-APIs und Scroll-Snap-Vorgänge, die nicht von Nutzerinnen oder Nutzern ausgelöst werden. Direktes Scrollen per Geste oder Mausrad verändert sie nicht. Auf html steuert sie den Seiten-Viewport; eine Einstellung auf body wird nicht auf diesen Viewport übertragen. Browser können die Eigenschaft ignorieren.

Im Beispiel erzeugen overflow: auto und eine begrenzte Höhe einen Scrollcontainer. Ein Aufruf von scrollTo() mit behavior: 'auto' berücksichtigt den berechneten Wert von scroll-behavior und kann daher eine sanfte Bewegung auslösen. Das ist nicht dasselbe wie CSS scroll-behavior: auto. Prüfe die Endposition und nicht eine feste Animationsdauer.

Beispiele

<!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>

Ergebnis

After scrolling completes without interruption: panel.scrollTop === 240. No console output.

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen