轻松上手,快乐学习!

HTML DOM getElementsByName() 方法


实例

获取具有指定名称的所有元素:

var x = document.getElementsByName("fname");
亲自试一试 »

页面下方有更多实例。


定义和用法

getElementsByName() 方法以 HTMLCollection 对象的形式返回文档中具有指定名称(name 属性的值)的所有元素的集合。

HTMLCollection 对象表示节点的集合。这些节点可以通过索引号访问。索引从0开始。

提示: 可以使用 HTMLCollection 对象的 length 属性来确定具有指定名称的元素的数量,然后可以循环遍历所有元素并提取所需的信息。

注释: 在 HTML5 中, "name" 属性已被弃用,许多元素已被 "id" 属性取代。在适当的地方使用 document.getElementById() 方法。还可以查看 getElementsByClassName()getElementsByTagName() 方法。


浏览器支持

方法
getElementsByName() Yes Yes Yes Yes Yes

语法

document.getElementsByName(name)

参数值

参数 类型 描述
name String 必需。要访问/操作的元素的名称属性值

技术细节

DOM 版本: Core Level 1 Document Object
返回值: An HTMLCollection 对象,表示具有指定名称的元素集合。返回集合中的元素按其在源代码中的显示进行排序。

更多实例

实例

找出文档中有多少元素的name属性值为 "animal" (使用 HTMLCollection 对象的 length 属性)):

var x = document.getElementsByName("animal").length;
亲自试一试 »

实例

检查文档中所有带有 type="checkbox" 且名称属性值为 "animal" 的 <input> 元素:

var x = document.getElementsByName("animal");
var i;
for (i = 0; i < x.length; i++) {
  if (x[i].type == "checkbox") {
    x[i].checked = true;
  }
}
亲自试一试 »

❮ Document 对象