element.name

概要

name はDOM オブジェクトのname 属性を取得または設定します。

ただし、この属性が適用されるのは次の要素に限られます。

<a>, <applet>, <form>, <frame>, <iframe>, <img>, <input>, <map>, <meta>, <object>, <option>, <param>, <select>, <textarea>.

name は、 document.getElementsByName() メソッドか、 form と form.elements のコレクションで使用することができます。 form や form.elements のコレクションで使われた場合、一つの要素かコレクションを返します。

構文

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">

  // form の最初の要素の参照を取得します。
  var formElement = document.forms['formA'].elements[0];

  // name 属性を設定します。
  formElement.name = 'inputA';

  // input の value を表示します。 
  alert(document.forms['formA'].elements['inputA'].value);
 
</script>

注記

Internet Explorer (IE)では、 document.createElement()を使って作成されたDOM オブジェクトの name 属性 は、設定および変更をすることができません。

仕様

W3C DOM 2 HTML Specification:

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