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:
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