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.