CKTIS / JavaScript
HTMLElement.style.scrollBehavior — настройване на плавно превъртане
Прочитай, задавай или премахвай CSS декларацията `scroll-behavior` в стила на самия елемент и я разграничавай от стойността след каскадата и от настройката за едно извикване.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
element.style.scrollBehavior;
element.style.scrollBehavior = "smooth";
element.style.scrollBehavior = "auto";
element.style.scrollBehavior = "";HTMLElement.style.scrollBehavior е свойство на CSSOM в обекта style на конкретен HTML елемент. То не е статично свойство на конструктора HTMLElement и не е част от ECMAScript. Използвай element.style.scrollBehavior, за да прочетеш или промениш CSS декларацията за scroll-behavior, зададена директно в стила на елемента.
Ако такава декларация липсва в стила на елемента, прочитането връща "", дори когато свойството е зададено в таблица със стилове. Присвояването на "" премахва само тази декларация, а присвояването на "auto" я задава изрично. За елемент, свързан с документа, използвай getComputedStyle(element).scrollBehavior, за да видиш стойността след прилагане на каскадата.
Задаването на свойството не започва превъртане. То определя как се превърта даден контейнер, когато превъртането е предизвикано от навигация, например връзка към част от страницата, или от API на CSSOM за превъртане. Не променя прякото превъртане с колелце или жест. В CSS auto е началната стойност и означава незабавно превъртане; smooth заявява анимация, чиято продължителност и темп се определят от браузъра. Свойството не се наследява по подразбиране и браузърът може да го пренебрегне.
За видимата област на HTML страницата използвай кореновия елемент (document.documentElement); декларация върху document.body не се пренася към тази област. В element.scrollTo({ top: 100, behavior: "auto" }) опцията "auto" следва CSS, а "smooth" и "instant" избират поведението само за това извикване. "instant" не е валидна CSS стойност за scroll-behavior. Не налагай плавно превъртане, когато условието prefers-reduced-motion: reduce е изпълнено.
Примери
<!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>Резултат
"" "smooth" ""
Примерът използва елемент, който не е свързан с документа, за да покаже прочитане, задаване и премахване на декларацията, без да превърта страницата. `JSON.stringify()` показва празния низ като `""`.
Свързани уроци
- JavaScript · Урок 37 · Напреднало · Версия: 4