Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

HTMLElement.style.scrollBehavior — nastavení plynulého posouvání

Čtěte, nastavujte a odstraňujte deklaraci CSS `scroll-behavior` přímo ve stylu elementu. Rozlišujte ji od výsledné hodnoty CSS a od volby pro jedno volání posouvací metody.

Verze: ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

element.style.scrollBehavior;
element.style.scrollBehavior = "smooth";
element.style.scrollBehavior = "auto";
element.style.scrollBehavior = "";

HTMLElement.style.scrollBehavior je vlastnost CSSOM na objektu style konkrétního HTML elementu. Není to statická vlastnost konstruktoru HTMLElement ani součást ECMAScriptu. Pomocí element.style.scrollBehavior přečtete nebo změníte deklaraci CSS scroll-behavior zapsanou přímo ve stylu elementu.

Pokud taková deklarace v přímém stylu chybí, čtení vrátí "", i když vlastnost nastavuje šablona stylů. Přiřazení "" odstraní pouze tuto deklaraci; přiřazení "auto" ji výslovně nastaví. U elementu připojeného k dokumentu zjistíte hodnotu po vyhodnocení kaskády pomocí getComputedStyle(element).scrollBehavior.

Nastavení vlastnosti posouvání nespustí. Určuje, jak se posuvný kontejner pohybuje, když posouvání vyvolá navigace, například odkaz na fragment stránky, nebo posouvací API CSSOM. Přímé posouvání kolečkem nebo gestem nemění. V CSS je auto počáteční hodnota a znamená okamžité posunutí; smooth požaduje animaci, jejíž délku a průběh určí prohlížeč. Vlastnost se ve výchozím nastavení nedědí a prohlížeč ji může ignorovat.

Pro oblast zobrazení HTML stránky použijte kořenový element (document.documentElement); deklarace na document.body se do této oblasti nepřenáší. V element.scrollTo({ top: 100, behavior: "auto" }) se "auto" řídí CSS; "smooth" a "instant" vybírají chování jen pro dané volání. "instant" není platná hodnota CSS vlastnosti scroll-behavior. Nevynucujte plynulé posouvání, pokud platí prefers-reduced-motion: reduce.

Pří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ýsledek

""
"smooth"
""

Příklad používá element nepřipojený k dokumentu a ukazuje čtení, nastavení i odstranění deklarace bez posunutí stránky. `JSON.stringify()` zobrazí prázdný řetězec jako `""`.

Související lekce

  • JavaScript · Lekce 37 · Pokročilá · Verze: 4

Zdroje