Document.getElementsByName() - Web APIs 编辑
The getElementsByName()
method of the Document
object returns a NodeList
Collection of elements with a given name
in the document.
Syntax
var elements = document.getElementsByName(name);
- elements is a live
NodeList
Collection, meaning it automatically updates as new elements with the samename
are added to/removed from the document. - name is the value of the
name
attribute of the element(s).
Example
<!DOCTYPE html>
<html lang="en">
<title>Example: using document.getElementsByName</title>
<input type="hidden" name="up">
<input type="hidden" name="down">
<script>
var up_names = document.getElementsByName("up");
console.log(up_names[0].tagName); // displays "INPUT"
</script>
</html>
Notes
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.
The getElementsByName method works differently in IE10 and below. There, getElementsByName()
also returns elements that have an id
attribute with the specified value. Be careful not to use the same string as both a name
and an id
.
The getElementsByName method works differently in IE. There, getElementsByName()
does not return all elements which may not have a name
attribute (such as <span>
).
Both IE and Edge return an HTMLCollection
, not a NodeList
Specifications
Specification | Status | Comment |
---|---|---|
HTML Living Standard The definition of 'Document.getElementsByName()' in that specification. | Living Standard | |
Document Object Model (DOM) Level 2 HTML Specification The definition of 'Document.getElementsByName()' in that specification. | Obsolete | Initial definition |
Browser compatibility
BCD tables only load in the browser
See also
document.getElementById()
to return a reference to an element by its uniqueid
document.getElementsByTagName()
to return references to elements with the same tag namedocument.querySelector()
to return references to elements via CSS selectors like'div.myclass'
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论