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仕様です。

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

 Back to top