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

CKTIS / HTML

onmouseover — tratar a entrada do ponteiro

O atributo onmouseover contém JavaScript que trata o evento mouseover. Permite reagir quando o ponteiro entra num elemento, mas não substitui o suporte para o teclado e também pode tratar eventos com origem nos elementos descendentes.

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

Sintaxe

onmouseover="JavaScript statements"

onmouseover é um atributo global de HTML que trata o evento mouseover. O seu valor é o corpo de uma função JavaScript, não um URL nem o nome de um evento. O código é executado quando o evento correspondente é recebido; adicionar o atributo não o executa por si só.

Num controlador definido num atributo, this refere-se ao elemento que trata o evento e event fornece o objeto do evento. O atributo contém texto de código; a propriedade JavaScript element.onmouseover aceita uma função ou null.

mouseover propaga-se, pelo que um controlador num elemento antepassado também pode reagir quando o ponteiro entra num descendente. A passagem entre descendentes pode causar novas invocações. Não o confunda com mouseenter, que não se propaga.

Não faça depender uma funcionalidade essencial exclusivamente da passagem do ponteiro. O exemplo acrescenta uma resposta separada a onfocus para utilização com o teclado. A Content Security Policy pode bloquear código em atributos; nunca insira nele dados não fidedignos.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onmouseover demo</title>
<button type="button" onmouseover="this.textContent = 'mouseover received'" onfocus="this.textContent = 'focus received'">Try mouse or keyboard</button>
</html>

Resultado

Mouse: mouseover received
Keyboard focus: focus received

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