ZVON > References > DOM2 Reference

namedItem (method )

Owning interface and usage:  
HTMLCollection.namedItem(name)

Member of these other interfaces:  
none

Description:  
This method retrieves a Node using a name. With HTML documents, it first searches for a Node with a matching id attribute. If it doesn't find one, it then searches for a Node with a matching name attribute, but only on those elements that are allowed a name attribute. With XHTML documents, this method only searches for Nodes with a matching id attribute. This method is case insensitive in HTML documents and case sensitive in XHTML documents.

Parameters:  
DOMString name  -  The name of the Node to be fetched.

Returns:  
Node -  The Node with a name or id attribute whose value corresponds to the specified string. Upon failure (e.g., no node with this name exists), returns null.

Exceptions:  
none