Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

onscroll — obravnavanje dogodkov drsenja

Atribut onscroll vsebuje JavaScript, ki se izvede, ko je prejet dogodek scroll. Elementu omogoča odziv na drsenje, vendar sam ne ustvari območja, po katerem je mogoče drseti.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

<div onscroll="/* JavaScript statements */">...</div>

onscroll je globalni atribut za obravnavo dogodka scroll. Njegova vrednost je telo funkcije JavaScript, ne URL. Atribut sam po sebi ne omogoči drsenja; primer ustvari območje za drsenje tako, da omeji njegovo višino in nastavi overflow:auto.

Atributa HTML ne zamenjujte z lastnostjo JavaScript element.onscroll, ki ji dodelimo funkcijo ali null. Obe obliki uporabljata isto mesto za obravnavo. Pri elementih body in frameset se onscroll nanaša na obravnavo objekta Window, ne na neodvisno obravnavo tega elementa.

Content Security Policy lahko blokira obravnavo, zapisano v atributih. V primeru je odstavek za prikaz stanja sprva prazen. Skript premakne vsebino okvirja tako, da lastnosti box.scrollTop dodeli vrednost box.scrollHeight, nato pa s klicem box.dispatchEvent(new Event('scroll')) sproži sintetični dogodek scroll. Funkcija za obravnavo dogodka v odstavek zapiše scroll: offset changed, ne da bi bilo treba vsebino ročno premakniti. Sporočilo omogoča preverjanje rezultata brez predpostavke o določenem številu dogodkov.

Primeri

<!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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri