XML DOM getElementById() -menetelmä
Määrittely ja käyttö
getElementById() -menetelmä etsii elementtiä, jolla on määritelty yksilöllinen ID.
Syntaksi:
getElementById(elementid)
| Parametrit | Kuvaus |
|---|---|
| elementid | haluamasi elementin id-ominaisuuden arvo. |
Palautusarvo
Element-solmu, joka edustaa asiakirjaelementtiä, jolla on määritelty id-ominaisuus. Jos tällaista elementtiä ei löydy, palauttaa null.
Selitys
Tämä menetelmä hakee id-ominaisuuden arvoksi elementid elementin solmu, ja palauttaa sen. Jos tällaista solmua ei löydy, palauttaa null. id-ominaisuuden arvo on ainutlaatuinen asiakirjassa, jos tämä menetelmä löytää useita elementid elementin solmu, joka satunnaisesti palauttaa tällaisen solmun tai palauttaa null.
Tämä on tärkeä ja usein käytetty menetelmä, koska se tarjoaa yksinkertaisen tavan saada Element-objekti, joka edustaa tiettyä asiakirjaelementtiä.
Huomioitavaa:Menetelmän nimi päättyy Id:ään, ei ID:ään, älä kirjoita väärin.
HTML-dokumentissa tämä menetelmä aina hakee määritellyllä id-ominaisuudella varustettuja elementtejä. Voit käyttää HTMLDocument.getElementByName() -menetelmä, etsiessään HTML-elementtejä niiden name-ominaisuuksien arvon perusteella.
XML-dokumentissa tämä menetelmä käyttää id-tyyppistä minkä tahansa ominaisuutta etsiessä, riippumatta ominaisuuden nimestä. Jos XML-ominaisuden tyyppi on tuntematon (esim. XML-parsin ohitti tai ei voi sijoittaa dokumentin DTD:ää), tämä menetelmä palauttaa aina null. Asennus JavaScriptissä ei usein käytetä XML-dokumenttien kanssa. Itse asiassa getElementById() määriteltiin alun perin HTMLDocument-rinnakkaisuuden jäseneksi, mutta myöhemmässä 2. DOM-luokassa se siirrettiin Document-rinnakkaisuuteen.
