Oggetto Event XML DOM

L'oggetto Event rappresenta informazioni sull'evento.

Oggetto Event

Le proprietà dell'oggetto Event forniscono dettagli sull'evento (ad esempio, l'elemento su cui è avvenuto l'evento). I metodi dell'oggetto Event possono controllare la propagazione dell'evento.

Lo standard 2 del DOM Events definisce un modello di eventi standard, implementato da tutti i browser moderni tranne IE, che definisce un modello proprio e incompatibile. Questa pagina di riferimento elenca le proprietà dell'oggetto Event standard e quelle dell'oggetto Event di IE.

Attenzione:Nella modello di eventi standard, l'oggetto Event viene passato alla funzione di gestione degli eventi; ma nel modello di eventi di IE, viene memorizzato nella proprietà event dell'oggetto Window.

Nel modello di eventi standard, le diverse interfacce di Event definiscono proprietà aggiuntive che forniscono dettagli relativi a tipi di evento specifici. Nel modello di eventi di IE, c'è solo un tipo di oggetto Event, utilizzato per tutti i tipi di eventi.

Proprietà Event standard

Di seguito sono elencate le proprietà definite dallo standard 2 del DOM Event.

Proprietà Descrizione IE F O W3C
bubbles Restituire un valore booleano che indica se l'evento è di tipo bollettazione. No 1 9 Sì
cancelable Restituire un valore booleano che indica se l'azione predefinita dell'evento è annullabile. No 1 9 Sì
currentTarget Restituire l'elemento che ha attivato l'evento tramite il suo listener. No 1 9 Sì
eventPhase Restituire la fase corrente di propagazione dell'evento. 　 　 　 Sì
target Restituire l'elemento che ha generato l'evento (il nodo target dell'evento). No 1 9 Sì
timeStamp Restituire la data e l'ora di generazione dell'evento. No 1 9 Sì
type Restituire il nome dell'evento rappresentato dall'oggetto Event corrente. 6 1 9 Sì

Metodi Event standard

Di seguito sono elencati i metodi definiti dallo standard 2 del DOM Event. Il modello di eventi di IE non supporta questi metodi:

Metodo Descrizione IE F O W3C
initEvent() Inizializzare le proprietà dell'oggetto Event creato di recente. No 1 9 Sì
preventDefault() Notificare al browser di non eseguire l'azione predefinita associata all'evento. No 1 9 Sì
stopPropagation() Interrompere la propagazione dell'evento durante la fase di cattura, di elaborazione del target o di bollettazione. No 1 9 Sì

Proprietà IE

IE non supporta (almeno in IE 7) il modello di eventi DOM standard, e l'oggetto Event di IE definisce un insieme di proprietà completamente diversi.

Il modello di eventi IE non definisce un livello di ereditarietà per diversi tipi di eventi, quindi tutte le proprietà correlate a qualsiasi tipo di evento sono elencate qui.

Proprietà Descrizione
cancelBubble Se l'handler dell'evento desidera impedire la propagazione dell'evento all'oggetto contenitore, deve impostare questa proprietà su true.
fromElement Per gli eventi mouseover e mouseout, fromElement si riferisce all'elemento del mouse che si è mosso.
keyCode

Per gli eventi keypress, l'attributo dichiara il codice Unicode del carattere generato dalla chiave premuta.

Per gli eventi keydown e keyup, specifica il codice della tastiera virtuale della chiave premuta.

Il codice della tastiera virtuale potrebbe essere correlato alla configurazione della tastiera utilizzata.
offsetX,offsetY Le coordinate x e y del luogo dell'evento nel sistema di coordinate dell'elemento sorgente dell'evento.
returnValue

Se è impostata questa proprietà, il suo valore ha priorità rispetto al valore di ritorno dell'handler dell'evento.

Impostando questa proprietà su fasle, è possibile annullare l'azione predefinita dell'elemento sorgente dell'evento.
srcElement Per il Window oggetto, Document oggetto o Element oggetto che genera l'evento, è un riferimento.
toElement Per gli eventi mouseover e mouseout, l'attributo si riferisce all'elemento del mouse che si è mosso.
x,y Le coordinate x e y del luogo dell'evento, che sono relative all'elemento contenitore più interno posizionato dinamicamente con CSS.