Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

onwheel — el controlador del evento wheel

El atributo HTML global onwheel especifica el código que gestiona el evento wheel. No es un atributo booleano: su valor contiene instrucciones JavaScript.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

onwheel="JavaScript statements"
element.onwheel = function (event) { /* ... */ };
element.onwheel = null;

onwheel es un atributo global de gestión de eventos disponible en todos los elementos HTML. Corresponde al evento wheel, no a scroll.

El valor del atributo es el cuerpo de una función JavaScript, que tiene disponible el parámetro event. En cambio, a la propiedad element.onwheel se le asigna una función; otra asignación la sustituye, y null elimina ese controlador. Una Content Security Policy puede bloquear el código del atributo.

El ejemplo envía un evento wheel sintético y establece el texto del elemento en wheel. No simula el movimiento físico de una rueda ni el desplazamiento.

Ejemplos

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

Resultado

wheel

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes