Name
HTMLDocument.getElementsByName( ): find elements with the specified name attribute â DOM Level 2 HTML
Synopsis
Element[] getElementsByName(StringelementName
);
Arguments
-
elementName
The desired value for the
name
attribute.
Returns
A read-only array (technically a NodeList) of Element
objects that have a name
attribute with the specified value. If no such elements are found,
the returned array is empty and has a length
of 0.
Description
This method searches an HTML document tree for Element nodes
that have a name
attribute of the
specified value and returns a NodeList (which you can treat as a
read-only array) containing all matching elements. If there are no
matching elements, a NodeList with length
0 is returned.
Do not confuse this method with the Document.getElementById( )
method, which
finds a single Element based on the unique value of an id
attribute, or with the Document.getElementsByTagName( )
method,
which returns a NodeList of elements with the specified tag
name.
See Also
Document.getElementById( )
,
Document.getElementsByTagName(
)
Get JavaScript: The Definitive Guide, 5th Edition now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.