Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

onscroll — obsługa zdarzenia przewijania

Atrybut onscroll zawiera JavaScript wykonywany po otrzymaniu zdarzenia scroll. Pozwala reagować na przewijanie, lecz sam nie tworzy przewijalnego obszaru.

Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately

Składnia

<div onscroll="/* JavaScript statements */">...</div>

onscroll to globalny atrybut obsługi zdarzenia scroll. Jego wartość jest treścią funkcji JavaScript, a nie adresem URL. Sam atrybut nie zapewnia przewijalności; przykład tworzy przewijalny obszar przez ograniczenie wysokości i ustawienie overflow:auto.

Nie myl atrybutu HTML z właściwością JavaScript element.onscroll, której przypisuje się funkcję lub null. Obie formy korzystają z tego samego miejsca na procedurę obsługi. Na elementach body i frameset nazwa onscroll odnosi się do procedury obsługi obiektu Window, a nie do niezależnej procedury tego elementu.

Polityka Content Security Policy może blokować obsługę wpisaną w atrybucie. W przykładzie akapit stanu jest początkowo pusty. Skrypt przewija zawartość obszaru, przypisując box.scrollHeight do box.scrollTop, a następnie wywołuje box.dispatchEvent(new Event('scroll')), aby wysłać syntetyczne zdarzenie scroll. Procedura obsługi wpisuje do akapitu tekst scroll: offset changed bez ręcznego przewijania. Komunikat pozwala sprawdzić wynik bez zakładania konkretnej liczby zdarzeń.

Przykłady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Element onscroll handler</title>
  <style>
    #box { block-size: 6rem; max-inline-size: 20rem; overflow: auto; border: 1px solid; }
    #content { block-size: 24rem; background: linear-gradient(#def, #468); }
  </style>
</head>
<body>
  <div id="box" role="region" aria-label="Scrollable sample" tabindex="0"
       onscroll="document.getElementById('result').textContent = event.type + (this.scrollTop > 0 ? ': offset changed' : ': at start')">
    <div id="content"></div>
  </div>
  <p id="result" role="status"></p>
  <script>
    const box = document.getElementById('box');
    box.scrollTop = box.scrollHeight;
    // Test the handler now rather than waiting for the browser's queued scroll event.
    box.dispatchEvent(new Event('scroll'));
  </script>
</body>
</html>

Wynik

scroll: offset changed

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła