Método namedItem() do XML DOM

Definição e uso

O método namedItem() recupera do conjunto o nó ou elemento com o nome especificado.

De acordo com o tipo de documento diferente, o comportamento deste método também é diferente:

  • Se o documento for um documento HTML, este método primeiro consulta os nós com o atributo id que coincide com o nome fornecido, se não houver atributo id correspondente, consulta os nós com o atributo name que coincide com o nome fornecido.

    Quando consultando o documento HTML, o método não é sensível a maiúsculas e minúsculas.

  • Se o documento for um documento XHTML, o método só consulta os nós com o atributo id que coincide com o nome fornecido.

    Quando consultando o documento HTML, o método é sensível a maiúsculas e minúsculas.

Sintaxe:

htmlcollectionObject.namedItem(name)
Parâmetros Descrição
name Nome do nó ou elemento a ser recuperado.

Retorno

Retorna o elemento ou nó com o atributo id ou name especificado. Se não houver tal nó na HTMLCollection, retorna null.

Descrição

No JavaScript, o HTMLCollection é tratado como um array associativo e a sintaxe de array é usada para colocar o nome entre [] para encontrar elementos, tornando-o mais fácil.

Exemplo

var c = document.forms;		//Este é um objeto HTMLCollection
var address = c.namedItem("address");	//Buscar <form name="address">
var payment = c["payment"];		//Sintaxe mais simples: buscar <form name="payment">
var login = c.login;		//Também é válido: buscar <form name="login">