XML DOM getElementById() metod

Dokumentobjektets referenshandbok

Definition och användning

getElementById() metoden söker efter element med ett specifikt unikt ID.

Syntaks:

getElementById(elementid)
Parameter Beskrivning
elementid det id-attributvärde som du vill få tag på för elementet.

Returvärde

representerar Element-noden för dokumentelement med specifikt id-attribut. Om ingen sådan element hittas returneras null.

Beskrivning

Denna metod kommer att hämta id-attributets värde elementid elementnoden och returnerar den. Om ingen sådan element hittas returneras null. Värdet för id-attributet är unikt i dokumentet, om denna metod hittar fler med specifikt elementid elementnoden, den returnerar slumpmässigt en sådan nod eller returnerar null.

Detta är en viktig vanlig metod, eftersom den erbjuder ett enkelt sätt att få tag på Element-objekt som representerar specifika dokumentelement.

Observera:Metodens namn slutar med Id, inte ID, se till att inte skriva fel.

I HTML-dokument alltid söker denna metod efter attribut med angivet id. Man kan använda HTMLDocument.getElementByName() metod, baserat på deras name-attributets värde för att hitta HTML-element.

I XML-dokument används denna metod för att söka efter alla attribut av typen id, oavsett namnet på attributet. Om typen för XML-attributet är okänd (t.ex. om XML-parsern har ignorerat det eller inte kan lokalisera dokumentets DTD), returnerar metoden alltid null. I klient JavaScript används denna metod inte ofta tillsammans med XML-dokument. Faktiskt var getElementById() ursprungligen definierad som en medlem av HTMLDocument-gränssnittet, men flyttades till Document-gränssnittet i senare versioner av 2:a nivån DOM.

Se

Document.getElementsByTagName()

Element.getElementsByTagName()

HTMLDocument.getElementByName() metod

Dokumentobjektets referenshandbok