--- title: Element.name slug: Web/API/Element/name translation_of: Web/API translation_of_original: Web/API/Element/name ---

{{ APIRef() }}

概述

name 获取或设置一个 DOM 对象的 name 属性；它只能应用于下列元素：{{ HTMLelement("a") }}, {{ HTMLelement("applet") }}, {{ HTMLelement("button") }}, {{ HTMLelement("form") }}, {{ HTMLelement("frame") }}, {{ HTMLelement("iframe") }}, {{ HTMLelement("img") }}, {{ HTMLelement("input") }}, {{ HTMLelement("map") }}, {{ HTMLelement("meta") }}, {{ HTMLelement("object") }}, {{ HTMLelement("param") }}, {{ HTMLelement("select") }}, and {{ HTMLelement("textarea") }}.

需要注意的是，name 属性在其他类型元素上不存在。它不是 {{domxref("Element")}} 或 {{domxref("HTMLElement")}} 接口的一个属性。

Name 可被使用于 {{ domxref("document.getElementsByName()") }} 方法，form 以及 the form elements collection。当使用于表单（form）或表单元素（form elements collection）时，可能返回一个单独的元素或一个元素集合。

语法

HTMLElement.name = string;
var elName = HTMLElement.name;

var fControl = HTMLFormElement.elementName;
var controlCollection = HTMLFormElement.elements.elementName;

例子

<form action="" name="formA">
  <input type="text" value="foo">
</form>

<script type="text/javascript">

  // 获取表单中第一个元素的引用
  var formElement = document.forms['formA'].elements[0];

  // 设置一个 name
  formElement.name = 'inputA';

  // 显示 input 的 value 值
  alert(document.forms['formA'].elements['inputA'].value);

</script>

备注

在 IE6 中，使用 {{domxref("document.createElement()")}} 方法创建的 DOM 对象的 name 属性不能被更改。

规范

W3C DOM 2 HTML Specification: