Obiekt Event XML DOM

Obiekt Event reprezentuje informacje dotyczące zdarzenia.

Obiekt Event

Atrybuty obiektu Event dostarczają szczegółów dotyczących zdarzenia (na przykład, element, na którym zdarzenie miało miejsce). Metody obiektu Event mogą kontrolować propagację zdarzenia.

Standard 2. poziomu DOM Events definiuje standardowy model zdarzeń, który jest realizowany przez wszystkie nowoczesne przeglądarki oprócz IE, który definiuje własny, niekompatybilny model. Ta strona referencyjna wymienia atrybuty obiektu Event oraz atrybuty obiektu Event IE.

Uwaga:W standardowym modelu zdarzeń obiekt Event jest przekazywany do funkcji obsługi zdarzeń; w modelu zdarzeń IE jest on przechowywany w atrybucie event obiektu Window.

W standardowym modelu zdarzeń Event różne podinterfejsy Event definiują dodatkowe atrybuty, które dostarczają szczegółów związanych z konkretnym typem zdarzenia. W modelu zdarzeń IE istnieje tylko jeden typ obiektu Event, który jest używany dla wszystkich typów zdarzeń.

Standardowe atrybuty Event

Poniżej wymieniono atrybuty zdefiniowane przez standard 2. poziomu DOM zdarzeń.

Atrybut Opis IE F O W3C
bubbles Zwraca wartość logiczną, wskazującą, czy zdarzenie jest typem bąbelkowym. Nie 1 9 Tak
cancelable Zwraca wartość logiczną, wskazującą, czy zdarzenie można anulować domyślną akcję. Nie 1 9 Tak
currentTarget Zwraca element, który wywołał zdarzenie za pomocą swojego słuchacza zdarzeń. Nie 1 9 Tak
eventPhase Zwraca bieżącą fazę propagacji zdarzenia. 　 　 　 Tak
target Zwraca element, który wywołał to zdarzenie (węzeł docelowy zdarzenia). Nie 1 9 Tak
timeStamp Zwraca datę i czas wygenerowania zdarzenia. Nie 1 9 Tak
type Zwraca nazwę zdarzenia reprezentowanego przez bieżący obiekt Event. 6 1 9 Tak

Standardowe metody Event

Poniżej wymieniono metody zdefiniowane przez standard 2. poziomu DOM zdarzeń. Model zdarzeń IE nie obsługuje tych metod:

Metoda Opis IE F O W3C
initEvent() Inicjuje atrybuty obiektu Event nowo utworzonego. Nie 1 9 Tak
preventDefault() Informuj przeglądarkę, aby nie wykonywała domyślnej akcji związanej z zdarzeniem. Nie 1 9 Tak
stopPropagation() Zakończenie zdarzenia nie rozprzestrzenia się dalszej propagacji w fazie przechwytywania, przetwarzania celu lub fazy bąbelkowej. Wywołanie tej metody spowoduje, że zostanie wywołany programista obsługiujący zdarzenie na tym węźle, a zdarzenie nie będzie już dystrybuowane do innych węzłów. Nie 1 9 Tak

Atrybuty IE

IE nie obsługuje (co najmniej w IE 7) standardowego modelu zdarzeń DOM, a obiekt Event w IE definiuje zespół zupełnie innych atrybutów.

Modela zdarzeń IE nie definiuje hierarchii dziedziczenia dla różnych typów zdarzeń, więc wszystkie atrybuty związane z typem zdarzenia są tutaj wymienione.

Atrybut Opis
cancelBubble Jeśli handler zdarzenia chce zapobiec rozprzestrzenianiu się zdarzenia do obiektu opakowującego, musi ustawić tę właściwość na true.
fromElement Dla zdarzeń mouseover i mouseout, fromElement odnosi się do elementu, z którego przemieścił się kursor myszy.
keyCode

Dla zdarzenia keypress, ta właściwość deklaruje kod Unicode znaku generowanego przez naciśnięty klawisz.

Dla zdarzeń keydown i keyup, określa kod klawiatury wirtualnego naciśniętego klawisza.

Kod klawiatury wirtualnego może być związany z układem klawiatury używanego.
offsetX,offsetY Koordynaty x i y miejsca wydarzenia w układzie współrzędnych elementu źródłowego zdarzenia.
returnValue

Jeśli ustawiona, jej wartość ma wyższy priorytet niż wartość zwrócona przez handler zdarzenia.

Ustawienie tej właściwości na fasle pozwala na uniknięcie domyślnej akcji elementu źródłowego zdarzenia.
srcElement Odniesienie do obiektu Window, Document lub Element, który generuje zdarzenie.
toElement Dla zdarzeń mouseover i mouseout, ta właściwość odnosi się do elementu, do którego przemieścił się kursor myszy.
x,y Koordynaty x i y miejsca wydarzenia zdarzenia, które są względem najbliższego wewnętrznego elementu opartego na CSS dynamicznie umieszczonego.