XML DOM HTMLElement-objekti

Edellinen sivu DOM HTMLDocument
Seuraava sivu DOM NamedNodeMap

HTMLElement-objekti edustaa HTML:ssä olevaa elementtiä.

HTMLElement-objektin ominaisuudet

Jokaisella HTML-dokumentin elementillä on HTML-ominaisuus, joka vastaa elementin HTML-ominaisuuksia. Tässä on lueteltu kaikki HTML-merkkijonot, jotka tukevat näitä ominaisuuksia. Muita ominaisuuksia on erityisiä tietyille HTML-merkkijonoille. HTMLElement-objekti perii Node ja Element Objektin standardeja ominaisuuksia, jotka toteuttavat myös seuraavat epäviralliset ominaisuudet:

className

Määrittää elementin class-ominaisuuden. Huomaa: ominaisuuden nimi ei ole "class", koska "class" on varattu sana JavaScriptissä.

Tyyppi: String. Tila: kirjoitettava.

currentStyle

Tämä IE:hen erikoistunut ominaisuus sovelletaan elementin kaikkien CSS-ominaisuuksien ryhmään. Se on Window.getComputedStyle() -metodin IE:lle yksinomaan tarkoitettu korvaaja.

Tyyppi: String. Tila: kirjoitettava.

dir

Määrittää elementin dir-ominaisuuden, joka ilmoittaa dokumentin tekstin suunnan.

Tyyppi: String. Tila: kirjoitettava.

id

Määrittää elementin id-ominaisuuden. Dokumentissa ei ole kahta elementtiä, joilla on sama id-arvo.

Tyyppi: String. Tila: kirjoitettava.

innerHTML

Määrittää elementissä olevan merkkijonon, ei sisällä elementin alkua- ja loppumerkkiä. Tämän ominaisuuden käyttäminen palauttaa elementin sisällön HTML-tekstina. Kun asetetaan HTML-tekstiksi, elementin sisältöä voidaan korvata HTML:n analyysin avulla. Tämä ominaisuus ei ole sallittu dokumentin latauksen aikana. Tämä on IE4:stä peräisin oleva epävirallinen ominaisuus, joka on saanut kaikkien nykyisten selainten tuen.

Tyyppi: String. Tila: kirjoitettava.

lang

Määrittää elementin lang-ominaisuuden, joka ilmoittaa elementin sisällön kielikoodin.

Tyyppi: String. Tila: kirjoitettava.

offsetHeight, offsetWidth

Palauttaa elementin korkeuden ja leveyden pikseleinä. Tämä on epävirallinen mutta hyvin tuettu ominaisuus.

Tyyppi: int. Tila: luku.

offsetLeft

Palauttaa nykyisen elementin vasemman reunan etäisyyden sen sisältöelementin vasemman reunasta pikseleinä.

Tyyppi: int. Tila: luku.

offsetTop

Palauttaa nykyisen elementin yläreunan etäisyyden sen sisältöelementin yläreunaan pikseleinä.

Tyyppi: int. Tila: luku.

offsetParent

Palauttaa viittauksen lähimpään dynaamisesti sijoitettuun sisältöelementtiin, kaikkien etäisyyksien määrittely perustuu tähän elementtiin. Jos elementin style.display on asetettu noneen, tämä ominaisuus palauttaa nullin. Tämä on epävirallinen mutta hyvin tuettu ominaisuus.

Tyyppi:Node. Tila: luku.

scrollHeight, scrollWidth

Palauttaa elementin täyden korkeuden ja leveyden pikseleinä. Kun elementillä on pyyhkäisyke (esimerkiksi CSS:n overflow-ominaisuuden vuoksi), nämä ominaisuudet eivät ole samat kuin offsetHeight ja offsetWidth, koska offsetHeight ja offsetWidth raportoivat vain elementin näkyvän osan kokoa. Tämä on epävirallinen mutta hyvin tuettu ominaisuus.

Tyyppi: int. Tila: luku.

scrollTop, scrollLeft

Asettaa tai palauttaa elementin vasemman reunan tai yläreunan pinnan pikseleitä. Näitä pikseleitä käytetään vain, jos elementillä on pyyhkäisyke, esimerkiksi, jos elementin CSS overflow-ominaisuus on asetettu autoon. Nämä ominaisuudet määritetään myös dokumentin <body> tai <html>-merkinnöissä (tämä riippuu selaimesta) ja ne määrittelevät yhdessä dokumentin sijainnin. Huomaa, että nämä ominaisuudet eivät määritä <iframe>-merkinnän pyyhkäisymäärää. Tämä on epävirallinen mutta hyvin tuettu ominaisuus.

Tyyppi: int. Tila: kirjoitettava.

style

Palauttaa elementille asetetun sisäisen CSS-tyylin style-ominaisuuden arvon. Huomaa, että tämän ominaisuuden arvo ei ole merkkijono.

Tyyppi:CSS2Properties. Tila: luku.

title

Määrittelee elementin title-ominaisuuden. Kun hiiri on elementin päällä, monet selaimet näyttävät tämän ominaisuuden arvon elementin "työkalurivinä".

Tyyppi: String. Tila: kirjoitettava.

HTMLElement-objektin menetelmät

HTMLElement-objekti perii Node ja Element objektin standardeja menetelmiä. Tiettyjen elementtien tyyppien on toteutettava merkityisiä menetelmiä, CodeW3C.com HTML DOM -viittausopastarjoaa näiden metodien tiedot.

Useimmat nykyaikaiset selaimet toteuttavat seuraavan epävirallisen metodin:

Metodi	Kuvaus
scrollIntoView()	Rullaa dokumenttia. Nostaa elementin näkyviin ikkunan ylä- tai alapuolelle.

HTMLElement-objektien tapahtumakäsittelijät

Kaikki HTML-elementit, jotka vastaanottavat hiiren ja näppäimistön tapahtumia, voivat aiheuttaa tässä luetellut tapahtumakäsittelijät. Joissakin elementeissä, kuten linkkeissä ja painikkeissa, suoritetaan oletusarvoinen toiminto, kun nämä tapahtumat tapahtuvat. Tällaisissa elementeissä lisätietoja löytyyTiettyjen elementtien viittausosiotlöytyy.

Katso HTML-tilanteen ominaisuuksien viittausopastietää lisää HTML-tilanteen käsittelijöistä.