CKTIS / JavaScript
HTMLElement.style.scrollBehavior — postavljanje glatkog pomicanja
Pročitaj, postavi ili ukloni CSS deklaraciju `scroll-behavior` izravno u stilu elementa i razlikuj je od vrijednosti nakon kaskade i opcije za jedan poziv metode pomicanja.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
element.style.scrollBehavior;
element.style.scrollBehavior = "smooth";
element.style.scrollBehavior = "auto";
element.style.scrollBehavior = "";HTMLElement.style.scrollBehavior svojstvo je CSSOM-a na objektu style pojedinog HTML elementa. Nije statičko svojstvo konstruktora HTMLElement niti dio ECMAScripta. Pomoću element.style.scrollBehavior čitaš ili mijenjaš CSS deklaraciju scroll-behavior zapisanu izravno u stilu elementa.
Ako nema takve deklaracije u stilu elementa, čitanje vraća "", čak i kad svojstvo postavlja stilska datoteka. Dodjela "" uklanja samo tu deklaraciju; dodjela "auto" izričito je postavlja. Za element povezan s dokumentom upotrijebi getComputedStyle(element).scrollBehavior da provjeriš vrijednost nakon primjene kaskade.
Postavljanje svojstva ne pokreće pomicanje. Određuje kako se sadržaj pomiče kada pomicanje pokrene navigacija, primjerice poveznica na dio stranice, ili CSSOM API za pomicanje. Ne mijenja izravno pomicanje kotačićem ili gestom. U CSS-u je auto početna vrijednost i znači trenutačno pomicanje; smooth traži animaciju čije trajanje i tijek određuje preglednik. Svojstvo se prema zadanim postavkama ne nasljeđuje, a preglednik ga može zanemariti.
Za područje prikaza HTML stranice koristi korijenski element (document.documentElement); deklaracija na document.body ne prenosi se na područje prikaza. U element.scrollTo({ top: 100, behavior: "auto" }) opcija "auto" slijedi CSS, dok "smooth" i "instant" određuju ponašanje samo za taj poziv. "instant" nije valjana CSS vrijednost za scroll-behavior. Nemoj nametati glatko pomicanje ako je ispunjen uvjet prefers-reduced-motion: reduce.
Primjeri
<!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>Rezultat
"" "smooth" ""
Primjer koristi element koji nije povezan s dokumentom kako bi pokazao čitanje, postavljanje i uklanjanje deklaracije bez pomicanja stranice. `JSON.stringify()` prikazuje prazan niz znakova kao `""`.
Povezane lekcije
- JavaScript · Lekcija 37 · Napredno · Verzija: 4