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.