Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje