Objeto Event XML DOM

O objeto Event representa informações sobre o evento.

Objeto Event

As propriedades do objeto Event fornecem detalhes sobre o evento (por exemplo, o elemento no qual o evento ocorreu). Os métodos do objeto Event podem controlar a propagação do evento.

O padrão 2 de DOM Events define um modelo de evento padrão, que é implementado por todos os navegadores modernos exceto o IE, que define seu próprio, incompatível modelo. Esta página de referência lista as propriedades do objeto Event padrão e as propriedades do objeto Event do IE.

Atenção:No modelo de evento padrão, o objeto Event é passado para a função de manipulador de evento; no entanto, no modelo de evento do IE, ele é armazenado na propriedade event do objeto Window.

No modelo de evento padrão, os subinterfaces do Event definem propriedades adicionais que fornecem detalhes relacionados a tipos específicos de eventos. No modelo de evento do IE, há apenas um tipo de objeto Event, que é usado para todos os tipos de eventos.

Propriedades Event Padrão

A seguir, estão listadas as propriedades definidas pelo padrão de evento DOM de nível 2.

Atributo Descrição IE F O W3C
bubbles Retorna um valor booleano, indicando se o evento é um tipo de evento de bolha. Não 1 9 Sim
cancelable Retorna um valor booleano, indicando se o evento pode cancelar a ação padrão. Não 1 9 Sim
currentTarget Retorna o elemento que desencadeou o evento (o nó alvo do evento). Não 1 9 Sim
eventPhase Retorna o estágio atual de propagação do evento. 　 　 　 Sim
target Retorna o elemento que desencadeou o evento (o nó alvo do evento). Não 1 9 Sim
timeStamp Retorna a data e hora geradas pelo evento. Não 1 9 Sim
type Retorna o nome do evento representado pelo objeto Event atual. 6 1 9 Sim

Métodos Event Padrão

A seguir, estão listados os métodos definidos pelo padrão de evento DOM de nível 2. O modelo de evento do IE não suporta esses métodos:

Método Descrição IE F O W3C
initEvent() Inicializa as propriedades do objeto Event recém-criado. Não 1 9 Sim
preventDefault() Notifica o navegador para não executar a ação padrão associada ao evento. Não 1 9 Sim
stopPropagation() O evento de encerramento impede a propagação adicional do evento no processo de captura, no tratamento do alvo ou no estágio de bolha. Após a chamada deste método, o manipulador de evento do nó chamado para lidar com o evento será chamado e o evento não será distribuído para outros nós. Não 1 9 Sim

Propriedades do IE

O IE não suporta (pelo menos no IE 7) o modelo de evento DOM padrão, e o objeto Event do IE define um conjunto de propriedades completamente diferentes.

O modelo de evento IE não define uma hierarquia de herança para diferentes tipos de eventos, portanto, todas as propriedades relacionadas a qualquer tipo de evento estão listadas aqui.

Atributo Descrição
cancelBubble Se o manipulador de eventos quiser evitar que o evento se propague para o objeto de envoltória, deve definir essa propriedade como true.
fromElement Para os eventos mouseover e mouseout, a propriedade fromElement faz referência ao elemento que o mouse está saindo.
keyCode

Para o evento keypress, essa propriedade declara o código Unicode do caractere gerado pela tecla que foi tocada.

Para os eventos keydown e keyup, especifica o código de teclado virtual da tecla que foi tocada.

O código de teclado virtual pode estar relacionado ao layout do teclado utilizado.
offsetX,offsetY Coordenadas x e y do local onde o evento ocorreu, no sistema de coordenadas do elemento de origem do evento.
returnValue

Se essa propriedade foi definida, seu valor tem prioridade sobre o valor retornado pelo manipulador de eventos.

Definindo essa propriedade como false, é possível cancelar a ação padrão do elemento de origem do evento.
srcElement Para a referência do objeto Window, Document ou Element que gerou o evento.
toElement Para os eventos mouseover e mouseout, essa propriedade faz referência ao elemento que o mouse está sobre.
x,y Coordenadas x e y do local onde o evento ocorreu, em relação ao elemento de envoltória mais interno que foi posicionado dinamicamente com CSS.