XML DOM namedItem() Yöntemi

Tanım ve Kullanım

namedItem() yöntemi, belirtilen adla eşleşen düğüm veya elementi koleksiyondan alır.

Farklı belge türlerine göre, bu yöntemin davranışı da farklı olabilir:

  • Eğer belge HTML belgesi ise, bu yöntem öncelikle belirtilen adla eşleşen id özniteliğine sahip düğümleri sorgular, eşleşen bir id özniteliği yoksa belirtilen adla eşleşen name özniteliğine sahip düğümleri sorgular.

    HTML belgesi sorgulanırken bu yöntem büyük/küçük harfe duyarsızdır.

  • Belge XHTML belgesi ise, bu yöntem sadece belirtilen adla eşleşen id özelliğine sahip nodları sorgular.

    HTML belgesi sorgulanırken bu yöntem büyük/küçük harfe duyarlıdır.

Sözdizimi:

htmlcollectionObject.namedItem(Ad)
Parametre Açıklama
Ad Geri alınacak nod veya elementin adı.

Dönüş değeri

Belirtilen id veya name özelliğine sahip element veya nodu döndürür. Eğer HTMLCollection'ta böyle bir nod yoksa null döndürür.

Açıklama

JavaScript'te HTMLCollection'u ilişkili dizi olarak işlemek ve name'yi [] içinde array dilbilgisi ile aramak daha kolay olacaktır.

Örnek

var c = document.forms;		//Bu bir HTMLCollection nesnesidir
var address = c.namedItem("address");	//<form name="address">
var payment = c["payment"];		//Daha basit bir dil: <form name="payment">
var login = c.login;		//Bu da geçerlidir: <form name="login">