Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

element.name

概要

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

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

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

name は、 document.getElementsByName() メソッドか、 formform.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:

ドキュメントのタグと貢献者

 このページの貢献者: fscholz, Hasilt, dextra
 最終更新者: Hasilt,