Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

HTMLElement.style.scrollBehavior — ustawianie płynnego przewijania

Odczytuj, ustawiaj i usuwaj deklarację CSS `scroll-behavior` zapisaną bezpośrednio w stylu elementu. Odróżniaj ją od wartości wynikającej z kaskady i opcji pojedynczego przewinięcia.

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

Składnia

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

HTMLElement.style.scrollBehavior to właściwość CSSOM dostępna w obiekcie style konkretnego elementu HTML, a nie statyczna właściwość konstruktora HTMLElement ani część ECMAScript. element.style.scrollBehavior odczytuje lub zmienia deklarację CSS scroll-behavior w stylu wpisanym bezpośrednio w elemencie.

Gdy nie ma takiej deklaracji w stylu elementu, odczyt zwraca "", nawet jeśli wartość ustala arkusz stylów. Przypisanie "" usuwa tylko tę deklarację; przypisanie "auto" jawnie ją ustawia. Aby na elemencie podłączonym do dokumentu sprawdzić wartość po uwzględnieniu kaskady, użyj getComputedStyle(element).scrollBehavior.

Ustawienie tej właściwości nie rozpoczyna przewijania. Określa ona sposób przewijania kontenera po nawigacji, np. do kotwicy, lub po wywołaniu API przewijania CSSOM. Nie zmienia ręcznego przewijania kółkiem ani gestem. CSS-owe auto to wartość początkowa i oznacza przewijanie natychmiastowe; smooth oznacza animację, której czas i tempo określa przeglądarka. Właściwość nie jest dziedziczona domyślnie, a przeglądarka może ją zignorować.

Aby ustawić zachowanie obszaru widoku strony HTML, użyj elementu głównego (document.documentElement); deklaracja na document.body nie przenosi się na obszar widoku. W element.scrollTo({ top: 100, behavior: "auto" }) opcja "auto" odwołuje się do wartości CSS; "smooth" i "instant" wybierają zachowanie tego jednego wywołania. "instant" nie jest poprawną wartością CSS scroll-behavior. Gdy prefers-reduced-motion: reduce jest spełnione, unikaj wymuszania płynnego przewijania.

Przykłady

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

Wynik

""
"smooth"
""

Przykład używa elementu niepodłączonego do dokumentu, aby pokazać odczyt, zapis i usunięcie deklaracji bez przewijania strony. `JSON.stringify()` pokazuje pusty ciąg jako `""`.

Powiązane lekcje

  • JavaScript · Lekcja 37 · Zaawansowany · Wersja: 4

Źródła