1. 面向开发者的 Web 技术
  2. Web API
  3. Document
  4. Document：getElementsByName() 方法

此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Document：getElementsByName() 方法

基线 广泛可用

自 2018年1月 起，此特性已在主流浏览器中得到支持，可在大多数设备和浏览器版本中正常使用。

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

语法

js
getElementsByName(name)

参数

name

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

返回值

一个实时的 NodeList 集合，这意味着当带有相同 name 的新元素被添加到文档中，或从文档中移除时，该集合会自动更新。

示例

html
<!doctype html>
<html lang="en">
  <head>
    <title>示例：使用 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); // 显示“INPUT”

备注

name 属性只在（X）HTML 文档中可用。

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

规范

规范
HTML
# dom-document-getelementsbyname-dev

浏览器兼容性

参见

帮助改进 MDN

了解如何参与贡献

此页面最后更新于 ，由 MDN 贡献者更新。

在 GitHub 上查看此页面 • 报告此内容的问题