CKTIS / HTML
onscroll — gérer les événements de défilement
L’attribut onscroll contient du JavaScript exécuté lorsqu’un événement scroll est reçu. Il permet à un élément de réagir au défilement, mais ne crée pas à lui seul une zone défilante.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<div onscroll="/* JavaScript statements */">...</div>onscroll est un attribut global de gestion de l’événement scroll. Sa valeur est le corps d’une fonction JavaScript, et non une URL. L’attribut ne rend rien défilant à lui seul ; l’exemple crée une zone défilante en limitant sa hauteur et en définissant overflow:auto.
Ne confondez pas l’attribut HTML avec la propriété JavaScript element.onscroll, à laquelle on affecte une fonction ou null. Les deux formes utilisent le même emplacement de gestionnaire. Sur les éléments body et frameset, onscroll désigne le gestionnaire de Window, et non un gestionnaire indépendant sur cet élément.
La Content Security Policy peut bloquer les gestionnaires écrits dans des attributs. Dans l’exemple, le paragraphe de statut est initialement vide. Le script fait défiler le contenu de la zone en affectant box.scrollHeight à box.scrollTop, puis déclenche un événement scroll synthétique avec box.dispatchEvent(new Event('scroll')). Le gestionnaire écrit scroll: offset changed dans le paragraphe sans défilement manuel. Ce message permet de vérifier le résultat sans supposer un nombre particulier d’événements.
Exemples
<!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>Résultat
scroll: offset changed
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.