Metoda XML DOM namedItem()

Definicja i użycie

Metoda namedItem() pobiera z kolekcji węzeł lub element o podanej nazwie.

Zależnie od typu dokumentu, zachowanie tej metody jest również różne:

  • Jeśli dokument jest dokumentem HTML, ta metoda najpierw przeszuka węzły z atrybutem id o pasującym nazwie, a jeśli nie istnieje pasujący atrybut id, przeszuka węzły z atrybutem name o pasującej nazwie.

    Podczas wyszukiwania dokumentu HTML, metoda jest niewrażliwa na wielkość liter.

  • Jeśli dokument jest dokumentem XHTML, metoda wyszukuje tylko węzły z id, które pasują do podanego nazwy.

    Podczas wyszukiwania dokumentu HTML, metoda jest wrażliwa na wielkość liter.

Składnia:

htmlcollectionObject.namedItem(name)
Parametry Opis
name Nazwa węzła lub elementu do odebrania.

Zwracana wartość

Zwraca element lub węzeł o określonym id lub atrybucie name. Jeśli w HTMLCollection nie ma takiego węzła, zwraca null.

Opis

W JavaScript, traktuje się HTMLCollection jak związaną tablicę, i można łatwiej znaleźć elementy umieszczając name w []

Przykład

var c = document.forms;		//To jest obiekt HTMLCollection
var address = c.namedItem("address");	//Wyszukiwanie <form name="address">
var payment = c["payment"];		//Prostsza składnia: wyszukiwanie <form name="payment">
var login = c.login;		//To również jest skuteczne: wyszukiwanie <form name="login">