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

HTMLFormElement:elements 属性

· 52CE 我爱测

HTMLFormElement 的 **`elements`** 属性返回一个 HTMLFormControlsCollection,其中列出了 form 元素中包含的所有表单控件。

HTML DOM

HTMLFormElement 的 elements 属性返回一个 HTMLFormControlsCollection,其中列出了 form 元素中包含的所有表单控件。

你还可以独立使用 HTMLFormElement.length 属性只获取表单控件的数量。

你可以使用索引或元素的 name 或 id 属性访问返回集合中的特定表单控件。

在 HTML 5 之前,返回的对象是一个基于 HTMLFormControlsCollection 的 HTMLCollection。

[!NOTE] 同样,你也可以使用文档中的 Document.forms 属性获取给定文档中包含的所有表单的列表。

值

一个 HTMLFormControlsCollection,其中包含表单中所有非图像控件。这是一个实时集合;如果向表单添加或删除表单控件,此集合将更新并更改。

返回集合中的表单控件遵循树的前序深度优先遍历顺序出现在表单中。这称为树顺序。

只返回以下元素:

示例

快速语法示例

在此示例中,我们将了解如何获取表单控件列表,以及如何通过索引和名称或 ID 访问其成员。

<form id="my-form">
  <label>用户名:<input type="text" name="username" /></label>
  <label>全名:<input type="text" name="full-name" /></label>
  <label>密码:<input type="password" name="password" /></label>
</form>
const inputs = document.getElementById("my-form").elements;
const inputByIndex = inputs[0];
const inputByName = inputs["username"];

访问表单控件

此示例获取表单的元素列表,然后遍历该列表,查找类型为 "text" 的 input 元素,以便对它们执行某种形式的处理。

const inputs = document.getElementById("my-form").elements;

// 遍历表单控件
for (let i = 0; i < inputs.length; i++) {
  if (inputs[i].nodeName === "INPUT" && inputs[i].type === "text") {
    // 更新输入文本
    inputs[i].value.toLocaleUpperCase();
  }
}

禁用表单控件

const inputs = document.getElementById("my-form").elements;

// 遍历表单控件
for (let i = 0; i < inputs.length; i++) {
  // 禁用所有表单控件
  inputs[i].setAttribute("disabled", "");
}

规范

浏览器兼容性

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

资料来源与适用范围

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

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

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