XML DOM -Event-objekti

TapahtumaoBJECT edustaa tietoja tapahtumasta.

TapahtumaoBJECT

TapahtumaoBJECTin ominaisuudet tarjoavat yksityiskohtia tapahtumasta (esim. elementti, jossa tapahtuma tapahtuu). TapahtumaoBJECTin menetelmät voivat hallita tapahtuman leviämistä.

2. tason DOM Events -standardi määrittelee standarditapahtumamallin, jonka kaikki nykyaikaiset selaimet paitsi IE toteuttavat, ja IE määrittelee omansa, ei-sopivuuden mukaisen mallin. Tämä viittaus sivu lukee standarditapahtumaoBJECTin ominaisuudet sekä IE tapahtumaoBJECTin ominaisuudet.

Huomaa:Standarditapahtumamallissa Event-objekti välitetään tapahtumankäsittelijäfunktiolle; mutta IE:n tapahtumamallissa se tallennetaan Window-objektin event-ominaisuuteen.

Standarditapahtumamallissa Eventin eri alikontekstit määrittelevät lisäominaisuuksia, jotka tarjoavat yksityiskohtia tietystä tapahtumatyypistä. IE:n tapahtumamallissa on vain yksi tyyppinen Event-objekti, joka käytetään kaikissa tapahtumatyypeissä.

Standard Event ominaisuudet

Alla luetellaan 2. tason DOM-tapahtumastandardi määrittelemät ominaisuudet.

Ominaisuus Kuvaus IE F O W3C
bubbles Palauttaa totuusarvon, joka osoittaa, onko tapahtuma puhkeava tapahtumatyypin. Ei 1 9 Kyllä
cancelable Palauttaa totuusarvon, joka osoittaa, onko tapahtuma peruutettavissa. Ei 1 9 Kyllä
currentTarget Palauttaa elementin, joka laukaisi tapahtuman. Ei 1 9 Kyllä
eventPhase Palauttaa tapahtuman levittämisvaiheen.       Kyllä
target Palauttaa elementin, joka triggoi tämän tapahtuman (tapahtuman kohde). Ei 1 9 Kyllä
timeStamp Palauttaa tapahtuman luomisen päivämäärän ja kellonajan. Ei 1 9 Kyllä
type Palauttaa nykyisen Event-objektin edustaman tapahtuman nimen. 6 1 9 Kyllä

Standard Event menetelmät

Alla luetellaan 2. tason DOM-tapahtumastandardi määrittelemät menetelmät. IE:n tapahtumamalli ei tue näitä menetelmiä:

Metodi Kuvaus IE F O W3C
initEvent() Alustaa uudelleen luodun Event-objektin ominaisuudet. Ei 1 9 Kyllä
preventDefault() Ilmoita selaimeen, että ei suoriteta tapahtumaan liittyvää oletustoimintaa. Ei 1 9 Kyllä
stopPropagation() Lopeta tapahtuman levittäminen vastaanottamisvaiheessa, kohdeprosessoinnissa tai puhkeamisvaiheessa. Kun tämä metodi kutsutaan, kutsutaan tapahtuman käsittelyohjelmaa tässä solmussa, ja tapahtuma ei enää jaeta muihin solmuihin. Ei 1 9 Kyllä

IE ominaisuudet

IE ei tue (ainakaan IE 7:ssä) standardeja DOM-tapahtumamalleja, ja IE:n Event-objekti määrittelee joukon täysin erilaisia ominaisuuksia.

IE tapahtumamalli ei määrittele perinnätasoa eri tapahtumatyyppejä varten, joten kaikki ja mihin tahansa tapahtumatyyppeihin liittyvät ominaisuudet luetellaan täällä.

Ominaisuus Kuvaus
cancelBubble Jos tapahtumankäsittelijä haluaa estää tapahtuman levittymisen sisällyttävään objektiin, tämän ominaisuuden on asetettava arvoksi true.
fromElement mouseover- ja mouseout-tapahtumien tapauksessa, fromElement viittaa hiiren poistumisen kohteena olevaan elementtiin.
keyCode

keypress-tapahtumien tapauksessa, ominaisuus määrittää painetun näppäimen luovan Unicode-koodin.

keydown- ja keyup-tapahtumien tapauksessa, se määrittää painetun näppäimen virtuaalikoodin.

Näppäimistön virtuaalikoodit voivat olla liittyneitä käytettävään näppäimistön asetteluun.

offsetX,offsetY Tapahtuman tapahtumapaikan x- ja y-akselin koordinaatit tapahtumanlähteen elementin koordinaatistoissa.
returnValue

Jos tämä ominaisuus on asetettu, sen arvo on enemmän kuin tapahtumankäsittelijän palauttaman arvon prioriteetti.

Asettamalla tämän ominaisuuden arvoksi false voidaan estää tapahtuman oletusliikkeen suorittaminen tapahtuman lähtöelementissä.

srcElement Windows-, Document- tai Element-objektin viittaus, joka luo tapahtuman.
toElement mouseover- ja mouseout-tapahtumien tapauksessa, ominaisuus viittaa hiiren siirtymisen kohteena olevaan elementtiin.
x,y Tapahtuman tapahtumapaikan x- ja y-akselin koordinaatit, ne ovat suhteessa CSS:n dynaamisesti sijoitettuun sisäisimpään sisällyttävään elementtiin.