大网数据广告活动
Web 标准与前端开发

Document:getElementsByName() 方法

· 52CE 我爱测

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

DOM

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

语法

getElementsByName(name)

参数

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

返回值

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

示例

<!doctype html>
<html lang="en">
  <head>
    <title>示例:使用 document.getElementsByName</title>
  </head>
  <body>
    <input type="hidden" name="up" />
    <input type="hidden" name="down" />
  </body>
</html>
const up_names = document.getElementsByName("up");
console.log(up_names[0].tagName); // 显示“INPUT”

备注

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

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

规范

浏览器兼容性

参见

  • document.getElementById() 根据唯一 id 返回对元素的引用。
  • document.getElementsByTagName() 返回对具有相同标签名的元素的引用
  • document.querySelector() 通过 CSS 选择器(例如 'div.myclass')返回对元素的引用。

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。