CKTIS / HTML
onscroll — обработване на събития за превъртане
Атрибутът onscroll съдържа JavaScript, който се изпълнява при получаване на събитие scroll. Той позволява на даден елемент да реагира на превъртане, но сам по себе си не създава област за превъртане.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
<div onscroll="/* JavaScript statements */">...</div>onscroll е глобален атрибут за обработване на събитието scroll. Стойността му е тялото на JavaScript функция, а не URL. Самият атрибут не прави нищо превъртаемо; примерът създава област за превъртане, като ограничава височината ѝ и задава overflow:auto.
Не бъркайте HTML атрибута със свойството на JavaScript element.onscroll, на което се присвоява функция или null. Двете форми използват едно и също място за обработчик. При елементите body и frameset onscroll се отнася до обработчика на Window, а не до независим обработчик на този елемент.
Content Security Policy може да блокира обработчици, записани в атрибути. В примера абзацът за състоянието първоначално е празен. Скриптът превърта съдържанието на полето, като присвоява стойността на box.scrollHeight на box.scrollTop, а след това изпраща синтетично събитие scroll чрез box.dispatchEvent(new Event('scroll')). Обработчикът записва scroll: offset changed в абзаца, без да е необходимо ръчно превъртане. Съобщението позволява резултатът да се провери, без да се предполага определен брой събития.
Примери
<!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>Резултат
scroll: offset changed
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.