Metoda XML DOM getElementsByTagName()

Definicja i zastosowanie

Metoda getElementsByTagName() zwraca NodeList wszystkich elementów o określonej nazwie.

Gramatyka:

getElementsByTagName(name)
Parametry Opis
name Wartość ciągła znaków, określająca nazwę etykiety do wyszukiwania. Wartość "*" dopasowuje wszystkie węzły.

Wyjaśnienie

Ta metoda przechodzi przez potomków określonego elementu, zwracając tablicę Elementów (która jest obiektem NodeList), reprezentującą wszystkie dokumentowe elementy o określonej nazwie etykiety. Kolejność elementów w zwracanej tablicy odpowiada ich kolejności w kodzie źródłowym dokumentu.

Uwaga, interfejs Document również definiuje metodę getElementsByTagName(), która jest podobna do tej metody, ale przechodzi przez cały dokument, a nie przez potomków określonego elementu.

Przykład

W wszystkich przykładach użyjemy pliku XML books.xml, oraz funkcji JavaScript loadXMLDoc().

Poniższy kod pokazuje wartości wszystkich elementów <title> w pliku "books.xml":

xmlDoc=loadXMLDoc("books.xml");
x=xmlDoc.getElementsByTagName('title');
for (i=0;i<x.length;i++)
{
document.write(x[i].childNodes[0].nodeValue);
document.write("<br />");
}

Wyjście kodu powyżej:

Everyday Italian
Harry Potter
XQuery Kick Start
Learning XML