XML DOM -Event-objekti
- Edellinen sivu DOM Element
- Seuraava sivu DOM HTMLCollection
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. |
- Edellinen sivu DOM Element
- Seuraava sivu DOM HTMLCollection