XML DOM getElementById() metode

Document objekt referencemanual

Definition og brug

getElementById() metoden søger efter elementer med den specificerede unikke ID.

Syntaks:

getElementById(elementid)
parametre beskrivelse
elementid den id-attributværdi, du ønsker at få.

returnerværdi

repræsenterer Element-knuden for dokumentelementet med den specificerede id-attribut. Hvis ingen sådant element findes, returneres null.

beskrivelse

denne metode vil finde elementer med id-attributten værdi elementid elementknude, og returnere den. Hvis ingen sådan element findes, returneres null. Værdien af id-attributten er unik i dokumentet, hvis denne metode finder flere med den specificerede elementid elementknude, den vil tilfældigt returnere en sådan elementknude eller returnere null.

Dette er en vigtig almindelig brugsmetode, fordi den giver en enkel måde at få Element-objekter, der repræsenterer specifikke dokumentelementer.

Bemærk:Navnet på denne metode ender med Id, ikke ID, så undgå at stavemistake.

I HTML-dokumenter søger denne metode altid efter egenskaber med specificeret id. Man kan bruge HTMLDocument.getElementByName() metode, baseret på værdien af deres name-egenskab.

I XML-dokumenter bruges denne metode til at finde enhver egenskab af typen id, uanset navnet på egenskaben. Hvis typen af XML-egenskaben er ukendt (f.eks. hvis XML-parseren har ignoreret eller ikke kunne定位文档的 DTD),returnerer metoden altid null. Denne metode bruges ikke ofte sammen med XML-dokumenter i klient JavaScript. Faktisk blev getElementById() oprindeligt defineret som en medlem af HTMLDocument-grænsefladen, men blev senere flyttet til Document-grænsefladen i 2. DOM-niveau.

Se

Document.getElementsByTagName()

Element.getElementsByTagName()

HTMLDocument.getElementByName() metode

Document objekt referencemanual