CKTIS / JavaScript
HTMLElement.style.scrollBehavior — sanftes Scrollen einstellen
Lies, setze oder entferne die Inline-Deklaration `scroll-behavior` eines Elements und unterscheide sie vom aufgelösten CSS-Wert und von einer Option für einen einzelnen Scrollvorgang.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
element.style.scrollBehavior;
element.style.scrollBehavior = "smooth";
element.style.scrollBehavior = "auto";
element.style.scrollBehavior = "";HTMLElement.style.scrollBehavior ist eine CSSOM-Eigenschaft des style-Objekts eines konkreten HTML-Elements. Sie ist weder eine statische Eigenschaft des Konstruktors HTMLElement noch Teil von ECMAScript. Mit element.style.scrollBehavior liest oder änderst du die Inline-CSS-Deklaration für scroll-behavior.
Ohne Inline-Deklaration liefert der Zugriff "", auch wenn ein Stylesheet die Eigenschaft setzt. Die Zuweisung "" entfernt nur diese Deklaration; "auto" setzt sie ausdrücklich. Bei einem Element im Dokument zeigt getComputedStyle(element).scrollBehavior den nach der Kaskade aufgelösten Wert.
Das Setzen der Eigenschaft startet keinen Scrollvorgang. Sie bestimmt, wie ein Scrollcontainer scrollt, wenn etwa ein Link zu einem Seitenfragment oder eine CSSOM-Scroll-API den Vorgang auslöst. Direktes Scrollen per Mausrad oder Geste bleibt unverändert. In CSS ist auto der Anfangswert und bedeutet sofortiges Scrollen; smooth fordert eine Animation an, deren Dauer und Verlauf der Browser festlegt. Die Eigenschaft wird standardmäßig nicht vererbt, und Browser dürfen sie ignorieren.
Für den sichtbaren Seitenbereich (Viewport) einer HTML-Seite verwendest du das Wurzelelement (document.documentElement); eine Deklaration auf document.body wirkt nicht auf den Viewport. Bei element.scrollTo({ top: 100, behavior: "auto" }) richtet sich "auto" nach CSS; "smooth" und "instant" gelten nur für diesen Aufruf. "instant" ist kein gültiger Wert für die CSS-Eigenschaft scroll-behavior. Erzwinge kein sanftes Scrollen, wenn prefers-reduced-motion: reduce zutrifft.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Inline scroll behavior</title>
</head>
<body>
<script>
const element = document.createElement("div");
console.log(JSON.stringify(element.style.scrollBehavior));
element.style.scrollBehavior = "smooth";
console.log(JSON.stringify(element.style.getPropertyValue("scroll-behavior")));
element.style.scrollBehavior = "";
console.log(JSON.stringify(element.style.scrollBehavior));
</script>
</body>
</html>Ergebnis
"" "smooth" ""
Das Beispiel liest, setzt und entfernt die Deklaration an einem Element, das nicht im Dokument hängt. Die Seite scrollt dabei nicht. `JSON.stringify()` macht die leere Zeichenfolge als `""` sichtbar.
Zugehörige Lektionen
- JavaScript · Lektion 37 · Fortgeschritten · Version: 4