CKTIS / HTML
onscroll — zpracování událostí posouvání
Atribut onscroll obsahuje JavaScript, který se spustí při přijetí události scroll. Umožňuje prvku reagovat na posouvání, sám však nevytváří posuvnou oblast.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<div onscroll="/* JavaScript statements */">...</div>onscroll je globální atribut obsluhy události scroll. Jeho hodnotou je tělo funkce v JavaScriptu, nikoli URL. Samotný atribut posouvání neumožňuje; příklad vytvoří posuvnou oblast omezením její výšky a nastavením overflow:auto.
Nezaměňujte atribut HTML s vlastností JavaScriptu element.onscroll, které se přiřazuje funkce nebo null. Obě podoby používají stejný slot obsluhy. U prvků body a frameset označuje onscroll obsluhu objektu Window, nikoli samostatnou obsluhu daného prvku.
Content Security Policy může blokovat obsluhy zapsané v atributech. V příkladu je stavový odstavec zpočátku prázdný. Skript posune obsah rámečku přiřazením box.scrollHeight do box.scrollTop a poté pomocí box.dispatchEvent(new Event('scroll')) vyvolá syntetickou událost scroll. Obsluha zapíše do odstavce scroll: offset changed, aniž by bylo nutné obsah ručně posouvat. Zpráva umožňuje ověřit výsledek bez předpokladu konkrétního počtu událostí.
Příklady
<!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>Výsledek
scroll: offset changed
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.