CKTIS / JavaScript
HTMLElement.style.scrollBehavior — vloeiend scrollen instellen
Lees, wijzig of verwijder de inline CSS-declaratie `scroll-behavior` van een element en onderscheid die van de opgeloste CSS-waarde en van een optie voor één scrollaanroep.
Versie: 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 is een CSSOM-eigenschap op het style-object van een HTML-element. Het is geen statische eigenschap van de constructor HTMLElement en maakt geen deel uit van ECMAScript. Met element.style.scrollBehavior lees of wijzig je de inline CSS-declaratie voor scroll-behavior.
Zonder inline declaratie krijg je bij het uitlezen "", ook als een stylesheet de eigenschap instelt. Met "" verwijder je alleen die declaratie; met "auto" stel je haar expliciet in. Voor een element dat aan het document is gekoppeld, lees je de na de cascade opgeloste waarde met getComputedStyle(element).scrollBehavior.
Het instellen van deze eigenschap start geen scrollbeweging. Ze bepaalt hoe een scrollcontainer beweegt als navigatie, bijvoorbeeld via een link naar een paginafragment, of een CSSOM-scroll-API het scrollen in gang zet. Rechtstreeks scrollen met het muiswiel of een gebaar verandert niet. In CSS is auto de beginwaarde en betekent die onmiddellijk scrollen; smooth vraagt om een animatie waarvan de browser de duur en het verloop bepaalt. De eigenschap wordt standaard niet overgeërfd en browsers mogen haar negeren.
Gebruik voor de viewport van een HTML-pagina het hoofdelement (document.documentElement); een declaratie op document.body werkt niet door naar de viewport. In element.scrollTo({ top: 100, behavior: "auto" }) volgt "auto" de CSS; "smooth" en "instant" bepalen het gedrag alleen voor die aanroep. "instant" is geen geldige CSS-waarde voor scroll-behavior. Forceer geen vloeiend scrollen als prefers-reduced-motion: reduce van toepassing is.
Voorbeelden
<!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>Resultaat
"" "smooth" ""
Het voorbeeld leest, zet en verwijdert de declaratie op een element dat niet aan het document is gekoppeld, zodat de pagina niet beweegt. `JSON.stringify()` maakt de lege tekenreeks zichtbaar als `""`.
Gerelateerde lessen
- JavaScript · Les 37 · Gevorderd · Versie: 4