CKTIS / HTML
onscroll — obrada događaja pomicanja
Atribut onscroll sadrži JavaScript koji se izvršava kada se primi događaj scroll. Omogućuje elementu da reagira na pomicanje, ali sam ne stvara područje po kojem se može pomicati.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<div onscroll="/* JavaScript statements */">...</div>onscroll je globalni atribut za obradu događaja scroll. Njegova je vrijednost tijelo funkcije JavaScript, a ne URL. Sam atribut ne omogućuje pomicanje; primjer stvara područje po kojem se može pomicati tako što ograničava njegovu visinu i postavlja overflow:auto.
Nemojte brkati atribut HTML sa svojstvom JavaScripta element.onscroll, kojemu se dodjeljuje funkcija ili null. Oba oblika koriste isto mjesto za rukovatelja. Na elementima body i frameset, onscroll odnosi se na rukovatelja objekta Window, a ne na neovisnog rukovatelja tog elementa.
Content Security Policy može blokirati rukovatelje zapisane u atributima. U primjeru je odlomak za prikaz statusa u početku prazan. Skripta pomiče sadržaj okvira tako što svojstvu box.scrollTop dodjeljuje vrijednost box.scrollHeight, a zatim pozivom box.dispatchEvent(new Event('scroll')) pokreće sintetički događaj scroll. Rukovatelj upisuje scroll: offset changed u odlomak bez potrebe za ručnim pomicanjem sadržaja. Poruka omogućuje provjeru rezultata bez pretpostavke o određenom broju događaja.
Primjeri
<!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>Rezultat
scroll: offset changed
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.