Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

onwheel — o gestor do evento wheel

O atributo HTML global onwheel especifica o código que trata o evento wheel. Não é um atributo booleano: o seu valor contém instruções JavaScript.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

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

onwheel é um atributo global de tratamento de eventos, disponível em todos os elementos HTML. Corresponde ao evento wheel, não a scroll.

O valor do atributo é o corpo de uma função JavaScript, com o parâmetro event disponível. Já à propriedade element.onwheel é atribuída uma função; uma atribuição posterior substitui a anterior e null remove esse gestor. Uma Content Security Policy pode bloquear o código do atributo.

O exemplo envia um evento wheel sintético e define o texto do elemento como wheel. Não simula o movimento físico de uma roda nem a deslocação da página.

Exemplos

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes