The getElementsByName()
method of the Document
object returns a NodeList
Collection of elements with a given name
attribute in the document.
The getElementsByName()
method of the Document
object returns a NodeList
Collection of elements with a given name
attribute in the document.
js
getElementsByName(name)
name
The value of the name
attribute of the element(s) we are looking for.
A live NodeList
collection, meaning it automatically updates as new elements with the same name
are added to, or removed from, the document.
html
<!doctype html> <html lang="en"> <head> <title>Example: using document.getElementsByName</title> </head> <body> <input type="hidden" name="up" /> <input type="hidden" name="down" /> </body> </html>
js
const up_names = document.getElementsByName("up"); console.log(up_names[0].tagName); // displays "INPUT"
The name
attribute can only be applied in (X)HTML documents.
The returned NodeList
Collection contains all elements with the given name
, such as <meta>
, <object>
, and even elements which do not support the name
attribute at all.
Specification |
---|
HTML Standard # dom-document-getelementsbyname-dev |
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
getElementsByName |
1 | 12Before Edge 79, this method returns anHTMLCollection , not a NodeList . |
1 | 5Returns anHTMLCollection , not a NodeList |
5 | 1 | 4.4 | 18 | 4 | 10.1 | 1 | 1.0 |
document.getElementById()
to return a reference to an element by its unique id
document.getElementsByTagName()
to return references to elements with the same tag name document.querySelector()
to return references to elements via CSS selectors like 'div.myclass'
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Document/getElementsByName