XML DOM Event Object

Het Event-object vertegenwoordigt informatie over het evenement.

Event-object

De eigenschappen van het Event-object bieden details over het evenement (bijvoorbeeld, het element waarop het evenement plaatsvindt). De methoden van het Event-object kunnen de verspreiding van het evenement controleren.

Het 2e niveau van de DOM Events-standaard definieert een standaard eventmodel dat door alle moderne browsers, behalve IE, wordt geïmplementeerd, terwijl IE zijn eigen, niet-compatibele model definieert. Deze referentiepagina somt de eigenschappen van het standaard Event-object en de eigenschappen van het IE Event-object op.

Opmerking:In het standaard eventmodel wordt het Event-object doorgegeven aan de eventhandlerfunctie; in het IE-evenementenmodel wordt het echter opgeslagen in de event-eigenschap van het Window-object.

In de standaard eventmodel definieert elke subinterface van Event verschillende eigenschappen die details bieden met betrekking tot specifieke eventtypes. In het IE-evenementenmodel is er slechts één type Event-object, dat wordt gebruikt voor alle types gebeurtenissen.

Standaard Event-eigenschappen

Hieronder worden de eigenschappen opgesomd die door het 2e niveau van de DOM-evenementenstandaard worden gedefinieerd.

Property Description IE F O W3C
bubbles Geef een booleaanse waarde terug die aangeeft of het evenement een bubbelende evenementstype is. Nee 1 9 Ja
cancelable Geef een booleaanse waarde terug die aangeeft of het evenement een annuleerbare standaardactie kan hebben. Nee 1 9 Ja
currentTarget Geef het element weer dat de eventhandler heeft getriggerd. Nee 1 9 Ja
eventPhase Geef de huidige fase van de verspreiding van het evenement weer. 　 　 　 Ja
target Geef het element weer dat de gebeurtenis heeft geactiveerd (de doelknoop van het evenement). Nee 1 9 Ja
timeStamp Geef de datum en tijd weer waarop het evenement is gegenereerd. Nee 1 9 Ja
type Geef de naam van het evenement weer dat door het huidige Event-object wordt vertegenwoordigd. 6 1 9 Ja

Standaard Event-methoden

Hieronder worden de methoden gedefinieerd door het 2e niveau van de DOM-evenementenstandaard opgesomd. Het IE-evenementenmodel ondersteunt deze methoden niet:

Methode Description IE F O W3C
initEvent() Initialiseer de eigenschappen van het nieuw gecreëerde Event-object. Nee 1 9 Ja
preventDefault() Inlicht de browser om geen standaardacties uit te voeren die geassocieerd zijn met het evenement. Nee 1 9 Ja
stopPropagation() Beëindig het verdere verspreiden van het evenement tijdens de fase van het vangen, het verwerken van het doel of de bubbelstap van de verspreidingsproces. Na het aanroepen van deze methode wordt de eventhandler die het evenement op deze knoop behandelt aangeroepen, en het evenement wordt niet meer doorgestuurd naar andere knopen. Nee 1 9 Ja

IE-eigenschappen

IE ondersteunt (tenminste in IE 7) niet het standaard DOM-evenementenmodel, en het IE Event-object definieert een set volledig andere eigenschappen.

Het IE-evenementenmodel definieert geen hiërarchische lagen voor verschillende evenementen, dus alle eigenschappen die betrekking hebben op het type van elk evenement zijn hier opgesomd.

Property Description
cancelBubble If the event handler wants to prevent the event from propagating to the containing object, this property must be set to true.
fromElement For mouseover and mouseout events, fromElement refers to the element from which the mouse is removed.
keyCode

For keypress events, this property declares the Unicode character code generated by the key pressed.

For keydown and keyup events, it specifies the virtual keyboard code of the key pressed.

The virtual keyboard code may be related to the layout of the keyboard used.
offsetX,offsetY The x and y coordinates of the location where the event occurs in the coordinate system of the event source element.
returnValue

If this property is set, its value has a higher priority than the return value of the event handler.

Setting this property to false can cancel the default action of the source element that triggers the event.
srcElement For the reference to the Window object, Document object, or Element object that generates the event.
toElement For mouseover and mouseout events, this property refers to the element under the mouse.
x,y The x and y coordinates of the position where the event occurs, which are relative to the innermost containing element dynamically positioned with CSS.