Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

HTMLElement.style.scrollBehavior — nastavitev gladkega drsenja

Preberi, nastavi ali odstrani deklaracijo CSS `scroll-behavior` neposredno v slogu elementa ter jo loči od vrednosti po kaskadi in možnosti za posamezen klic metode za drsenje.

Različica: 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 je lastnost CSSOM na objektu style posameznega elementa HTML. Ni statična lastnost konstruktorja HTMLElement niti del ECMAScripta. Z element.style.scrollBehavior prebereš ali spremeniš deklaracijo CSS scroll-behavior, zapisano neposredno v slogu elementa.

Če v slogu elementa ni te deklaracije, branje vrne "", tudi če lastnost določa slogovna predloga. Prireditev "" odstrani samo to deklaracijo; prireditev "auto" jo izrecno nastavi. Pri elementu, ki je del dokumenta, uporabi getComputedStyle(element).scrollBehavior, da prebereš vrednost po upoštevanju kaskade.

Nastavitev te lastnosti ne sproži drsenja. Določa, kako se pomika drsni vsebnik, ko drsenje sproži navigacija, na primer povezava do razdelka na strani, ali API CSSOM za drsenje. Ne vpliva na neposredno drsenje s koleščkom ali potezo. V CSS je auto začetna vrednost in pomeni takojšen premik; smooth zahteva animacijo, katere trajanje in potek določi brskalnik. Lastnost se privzeto ne deduje in brskalnik jo lahko prezre.

Za prikazno območje strani HTML uporabi korenski element (document.documentElement); deklaracija na document.body se ne prenese na prikazno območje. V element.scrollTo({ top: 100, behavior: "auto" }) možnost "auto" upošteva CSS, "smooth" in "instant" pa določita obnašanje samo za ta klic. "instant" ni veljavna vrednost CSS za scroll-behavior. Ne vsiljuj gladkega drsenja, če je izpolnjen pogoj prefers-reduced-motion: reduce.

Primeri

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

Primer uporablja element, ki ni vključen v dokument, in prikaže branje, nastavitev ter odstranitev deklaracije brez premikanja strani. `JSON.stringify()` prikaže prazen niz kot `""`.

Povezane lekcije

  • JavaScript · Lekcija 37 · Napredna · Različica: 4

Viri