.name

nameは、DOMオブジェクトのnameプロパティの取得と設定を行います。 これは次の要素にのみ適用されます。
<a>、<applet>、<button>、<form>、<frame>、<iframe>、<img>、 <input>、<map>、<meta>、<object>、<param>、<select>、<textarea>

nameプロパティは、その他の要素上には存在しないことに注意してください。 それは要素(Element)、 またはHTMLElementインターフェースのプロパティではありません。

nameは、document.getElementsByName()メソッド、 form、form要素コレクションで使用することが可能です。 formまたは要素コレクションで使用された場合、単一の要素またはコレクションのどちらかが返されます。

文法

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内の1つ目の要素への参照を取得します。
  var formElement = document.forms['formA'].elements[0];

  // nameに'inputA'を割り当てます。
  formElement.name = 'inputA';

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

</script>

注意事項

Internet Explorer(IE)では、 document.createElement()を使用して作成されたDOMオブジェクトのnameプロパティは、 設定または変更することは出来ません。

仕様

W3CのDOM2のHTML仕様です。

 Back to top

© 2017 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.

このページは、ページトップのURL先のMozilla Developer Network(以下、MDN)のコンテンツを翻訳した内容を基に構成されています。 構成について異なる点も含まれますので、下記の項目を確認し、必要に応じて元のコンテンツをご確認ください。 もし、誤訳などの間違いを見つけましたら、 @tomofまで教えていただければ幸いです。

  • 特定のブラウザに特化しすぎている情報やあまりにも古い情報、 または試験的に導入されているようなAPIや機能については、省略していることがあります。
  • 例やデモについて、実際にページ内で動作させる関係で一部ソースコードを変更している場合や、 その例で使用しているコンテンツの単語や文章などを日本人向けに変更しいてる場合があります。
  • MDNの更新頻度が高いため、元のコンテンツと比べ情報が古くなっている可能性があります。
  • "訳注:"などの断わりを入れた上で、日本人向けの情報の追記を行っている事があります。