Element.name - Web API 接口参考 编辑

概述

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

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

Name 可被使用于 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 中，使用 document.createElement() 方法创建的 DOM 对象的 name 属性不能被更改。

规范

W3C DOM 2 HTML Specification:

• Anchor
• Applet
• Button
• Form
• Frame
• iFrame
• Image
• Input
• Map
• Meta
• Object
• Param
• Select
• Textarea