CKTIS / HTML
onwheel — le gestionnaire de l’événement wheel
L’attribut HTML global onwheel définit le code qui gère l’événement wheel. Ce n’est pas un attribut booléen : sa valeur contient des instructions JavaScript.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
onwheel="JavaScript statements"
element.onwheel = function (event) { /* ... */ };
element.onwheel = null;onwheel est un attribut global de gestion d’événement disponible sur tous les éléments HTML. Il correspond à l’événement wheel, et non à scroll.
La valeur de l’attribut est le corps d’une fonction JavaScript, avec le paramètre event disponible. En revanche, on affecte une fonction à la propriété element.onwheel ; une affectation ultérieure remplace la précédente, et null supprime ce gestionnaire. Une Content Security Policy peut bloquer le code des attributs.
L’exemple déclenche un événement wheel synthétique et définit le texte de l’élément sur wheel. Il ne simule ni le mouvement physique d’une molette ni le défilement.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onwheel example</title>
<div id="area" onwheel="this.textContent = event.type">Ready</div>
<script>
const area = document.getElementById('area');
area.dispatchEvent(new Event('wheel'));
</script>
</html>Résultat
wheel
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.