Objeto Event XML DOM

El objeto Evento representa información sobre el evento.

Objeto Evento

Las propiedades del objeto Evento proporcionan detalles sobre el evento (por ejemplo, el elemento en el que ocurre el evento). Los métodos del objeto Evento pueden controlar la propagación del evento.

El estándar de eventos DOM de nivel 2 define un modelo de eventos estándar que se implementa en todos los navegadores modernos excepto IE, que define su propio modelo incompatibles. Esta página de referencia enumera las propiedades del objeto Evento estándar y las propiedades del objeto Evento de IE.

Nota:En el modelo de eventos estándar, el objeto Evento se transmite a la función de manejo de eventos; sin embargo, en el modelo de eventos de IE, se almacena en la propiedad event del objeto Window.

En el modelo de eventos estándar, las diversas subinterfaz de Evento definen propiedades adicionales que proporcionan detalles relacionados con tipos específicos de eventos. En el modelo de eventos de IE, solo hay un tipo de objeto Evento, que se utiliza para todos los tipos de eventos.

Propiedades estándar de Evento

A continuación se enumeran las propiedades definidas por el estándar de eventos DOM de nivel 2.

Atributo Descripción IE F O W3C
bubbles Devuelve un valor booleano que indica si el evento es de tipo burbujeante. No 1 9 Sí
cancelable Devuelve un valor booleano que indica si el evento puede cancelar la acción predeterminada. No 1 9 Sí
currentTarget Devuelve el elemento que desencadenó el evento mediante su escucha de eventos. No 1 9 Sí
eventPhase Devuelve la fase actual de propagación del evento. 　 　 　 Sí
target Devuelve el elemento que desencadenó este evento (el nodo objetivo del evento). No 1 9 Sí
timeStamp Devuelve la fecha y hora en que se generó el evento. No 1 9 Sí
type Devuelve el nombre del evento representado por el objeto Evento actual. 6 1 9 Sí

Métodos estándar de Evento

A continuación se enumeran los métodos definidos por el estándar de eventos DOM de nivel 2. El modelo de eventos de IE no admite estos métodos:

Método Descripción IE F O W3C
initEvent() Inicializa las propiedades del objeto Evento recién creado. No 1 9 Sí
preventDefault() Notifica al navegador que no debe ejecutar la acción predeterminada asociada con el evento. No 1 9 Sí
stopPropagation() El evento de finalización detiene la propagación adicional del evento en la fase de captura, procesamiento del objetivo o burbujeo. Después de llamar a este método, se llama al programa de procesamiento del evento en este nodo, y el evento ya no se asigna a otros nodos. No 1 9 Sí

Propiedades de IE

IE no admite (al menos en IE 7) el modelo de eventos DOM estándar, y el objeto Evento de IE define un conjunto de propiedades completamente diferentes.

El modelo de eventos IE no define jerarquías de herencia para diferentes tipos de eventos, por lo que todas las propiedades relacionadas con cualquier tipo de evento se enumeran aquí.

Atributo Descripción
cancelBubble Si el gestor de eventos desea evitar que el evento se propague al objeto contenedor, debe configurar esta propiedad como true.
fromElement Para los eventos mouseover y mouseout, fromElement hace referencia al elemento del que sale el ratón.
keyCode

Para el evento keypress, esta propiedad declara el código de caracteres Unicode generado por la tecla pulsada.

Para los eventos keydown y keyup, especifica el código de teclado virtual de la tecla pulsada.

El código de teclado virtual puede estar relacionado con la disposición del teclado utilizado.
offsetX,offsetY Las coordenadas x e y del lugar donde ocurre el evento en el sistema de coordenadas del elemento fuente del evento.
returnValue

Si se configura esta propiedad, su valor tiene prioridad sobre el valor devuelto por el gestor de eventos.

Configurando esta propiedad como fasle, se puede cancelar la acción predeterminada del elemento de origen del evento.
srcElement Referencia al objeto Window, Documento o Elemento que genera el evento.
toElement Para los eventos mouseover y mouseout, este atributo hace referencia al elemento al que se mueve el ratón.
x,y Las coordenadas x e y del lugar donde ocurre el evento, que son relativos al elemento contenedor más interno dinámicamente posicionado con CSS.