XML DOM Event-objektet
- Föregående sida DOM Element
- Nästa sida DOM HTMLCollection
Event-objektet representerar information om händelsen.
Event-objekt
Egenskaperna för Event-objektet tillhandahåller detaljer om händelsen (t.ex., elementet där händelsen inträffade). Metoderna för Event-objektet kan kontrollera händelse spridningen.
2:a nivå DOM Events-standard definierar en standardiserad händelsmodell som implementeras av alla moderna webbläsare utom IE, som definierar sin egen, inkompatibla modell. Denna referenssida listar egenskaperna för det standardiserade Event-objektet samt egenskaperna för IE:s Event-objekt.
Observera:I den standardiserade händelsmodellen överförs Event-objektet till händelseshanteringsfunktionen; men i IE:s händelsmodell lagras det i Window-objektets event-egenskap.
I den standardiserade händelsmodellen definierar olika undergränssnitt för Event ytterligare egenskaper som tillhandahåller detaljer relaterade till specifika händelsetyper. I IE:s händelsmodell finns det bara ett typ av Event-objekt som används för alla typer av händelser.
Standard Event-egenskaper
Nedan listas egenskaperna definierade av 2:a nivå DOM-händelsstandard.
Egenskap | Beskrivning | IE | F | O | W3C |
---|---|---|---|---|---|
bubbles | Returnerar ett booleskt värde som indikerar om händelsen är en bubbling-händelse typ. | Nej | 1 | 9 | Ja |
cancelable | Returnerar ett booleskt värde som indikerar om händelsen kan ha en avbrytbar standardåtgärd. | Nej | 1 | 9 | Ja |
currentTarget | Returnerar elementet som har triggat händelsen med sin eventlyssnare. | Nej | 1 | 9 | Ja |
eventPhase | Returnerar den aktuella etappen för händelse spridning. | Ja | |||
target | Returnerar elementet som triggar denna händelse (händelsens målnod). | Nej | 1 | 9 | Ja |
timeStamp | Returnerar datum och tid för när händelsen genererades. | Nej | 1 | 9 | Ja |
type | Returnerar namnet på händelsen som representeras av det aktuella Event-objektet. | 6 | 1 | 9 | Ja |
Standard Event-metoder
Nedan listas metoder definierade av 2:a nivå DOM-händelsstandard. IE:s händelsmodell stöder inte dessa metoder:
Metoder | Beskrivning | IE | F | O | W3C |
---|---|---|---|---|---|
initEvent() | Initialisera egenskaperna för det nyskapade Event-objektet. | Nej | 1 | 9 | Ja |
preventDefault() | Meddela webbläsaren att inte utföra standardåtgärden som är associerad med händelsen. | Nej | 1 | 9 | Ja |
stopPropagation() | Avsluta händelse spridning vid insamlingsprocess, målbehandling eller bubbling-steg vidare spridning. Efter att ha anropat denna metod kommer hanteraren för händelsen på denna nod att anropas och händelsen kommer inte att fördelas till andra noder. | Nej | 1 | 9 | Ja |
IE-egenskaper
IE stöder inte (minst i IE 7) den standardiserade DOM-händelsmodellen och IE:s Event-objekt definierar en helt annan uppsättning egenskaper.
IE händelsmodellen definierar inte en arvsnivå för olika händelser, så alla egenskaper relaterade till typen av varje händelse är listade här.
Egenskap | Beskrivning |
---|---|
cancelBubble | Om eventhanteraren vill förhindra att händelsen sprids till inneslutande objekt måste denna egenskap sättas till true. |
fromElement | För mouseover- och mouseout-händelser refererar fromElement till elementet där musen flyttas bort från. |
keyCode |
För keypress-händelser deklarerar denna egenskap Unicode-kodet för den knackade tangenten. För keydown- och keyup-händelser specificerar denna egenskap den virtuella tangentbordscoden för den knackade tangenten. Virtuella tangentbordscoder kan vara relaterade till layouten för det tangentbord som används. |
offsetX,offsetY | x- och y-koordinaterna för platsen där händelsen inträffar i koordinatsystemet för källan till händelsen. |
returnValue |
Om denna egenskap är satt, har dess värde högre prioritet än eventhanterarens returvärde. Om du sätter denna egenskap till false kan du avbryta den förvalda åtgärden för källan till händelsen. |
srcElement | För referenser till Window-objektet, Document-objektet eller Element-objektet som genererar händelsen. |
toElement | För mouseover- och mouseout-händelser refererar denna egenskap till elementet där musen flyttas. |
x,y | x- och y-koordinaterna för platsen där händelsen inträffar, de relaterar till den inre inneslutande element som är dynamiskt positionerat med CSS. |
- Föregående sida DOM Element
- Nästa sida DOM HTMLCollection