Document：getElementsByName() 方法

getElementsByName() 方法是 Document 对象的方法，它返回一个包含文档中具有给定 name 属性的所有元素的 NodeList 集合。

语法

js
getElementsByName(name)

参数

name

我们要查找的元素的 name 属性的值。

返回值

一个实时的 NodeList 集合，这意味着当文档中添加或删除具有相同 name 的新元素时，它会自动更新。

示例

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"

注释

name 属性只能在 (X)HTML 文档中使用。

返回的 NodeList 集合包含所有具有给定 name 的元素，例如 <meta>、<object>，甚至是一些根本不支持 name 属性的元素。

规范

规范
HTML 标准
# dom-document-getelementsbyname-dev

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅