Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

HTMLElement.style.scrollBehavior — nastavenie plynulého posúvania

Čítajte, nastavujte a odstraňujte deklaráciu CSS `scroll-behavior` priamo v štýle prvku. Odlišujte ju od výslednej hodnoty CSS a od voľby pre jedno volanie metódy posúvania.

Verzia: 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 je vlastnosť CSSOM na objekte style konkrétneho HTML prvku. Nie je to statická vlastnosť konštruktora HTMLElement ani súčasť ECMAScriptu. Pomocou element.style.scrollBehavior prečítate alebo zmeníte deklaráciu CSS scroll-behavior zapísanú priamo v štýle prvku.

Ak deklarácia v priamom štýle chýba, čítanie vráti "", aj keď vlastnosť nastavuje hárok štýlov. Priradenie "" odstráni iba túto deklaráciu; priradenie "auto" ju výslovne nastaví. Na prvku pripojenom k dokumentu zistíte hodnotu po vyhodnotení kaskády pomocou getComputedStyle(element).scrollBehavior.

Nastavenie vlastnosti nespustí posúvanie. Určuje, ako sa posúvateľný kontajner pohybuje, keď posúvanie vyvolá navigácia, napríklad odkaz na fragment stránky, alebo API CSSOM na posúvanie. Nemení priame posúvanie kolieskom ani gestom. V CSS je auto počiatočná hodnota a znamená okamžité posunutie; smooth žiada animáciu, ktorej trvanie a priebeh určuje prehliadač. Vlastnosť sa predvolene nededí a prehliadač ju môže ignorovať.

Pre oblasť zobrazenia HTML stránky použite koreňový prvok (document.documentElement); deklarácia na document.body sa do tejto oblasti neprenáša. V element.scrollTo({ top: 100, behavior: "auto" }) sa "auto" riadi CSS; "smooth" a "instant" určujú správanie len pre dané volanie. "instant" nie je platná hodnota CSS vlastnosti scroll-behavior. Nevynucujte plynulé posúvanie, ak platí prefers-reduced-motion: reduce.

Príklady

<!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>

Výsledok

""
"smooth"
""

Príklad používa prvok nepripojený k dokumentu a ukazuje čítanie, nastavenie aj odstránenie deklarácie bez posunutia stránky. `JSON.stringify()` zobrazí prázdny reťazec ako `""`.

Súvisiace lekcie

  • JavaScript · Lekcia 37 · Pokročilá · Verzia: 4

Zdroje