`document.getElementsByName()` 是一个JavaScript DOM方法,用于获取文档中所有带有指定名称属性的元素集合。这个方法返回一个类似数组的对象(通常被称为HTMLCollection)。它不是真正的数组,因为它不包含所有的数组方法,但可以访问和使用它内部的元素和属性来执行相关操作。例如,你可以通过索引访问特定的元素。
使用示例:
假设你的HTML文档中有一些带有相同名称属性的元素,例如:`` 和 ``。你可以使用 `document.getElementsByName()` 来获取这些元素。
示例代码:
```javascript
var usernameInputs = document.getElementsByName('username'); // 获取所有名称为 'username' 的元素集合
var passwordInputs = document.getElementsByName('password'); // 获取所有名称为 'password' 的元素集合
```
如果文档中存在具有特定名称的元素,上述代码会返回一个包含这些元素的集合。然后你可以使用这个集合的索引或特定方法来访问或操作这些元素。例如:
```javascript
var firstUsernameInput = usernameInputs[0]; // 获取第一个 'username' 输入元素
var textValue = passwordInputs[1].value; // 获取第二个 'password' 输入元素的值
```
请注意,返回的对象是动态的,意味着当文档中的元素更改时(例如添加或删除),集合会自动更新。因此,如果你在后续的代码中改变了页面结构或动态添加了新元素,你需要再次调用 `getElementsByName()` 来获取最新的元素集合。