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.