--- title: element.name slug: conflicting/Web/API translation_of: Web/API translation_of_original: Web/API/Element/name original_slug: Web/API/Element/name ---

概要

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

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

{{ HTMLelement("a") }}, {{ HTMLelement("applet") }}, {{ HTMLelement("form") }}, {{ HTMLelement("frame") }}, {{ HTMLelement("iframe") }}, {{ HTMLelement("img") }}, {{ HTMLelement("input") }}, {{ HTMLelement("map") }}, {{ HTMLelement("meta") }}, {{ HTMLelement("object") }}, {{ HTMLelement("option") }}, {{ HTMLelement("param") }}, {{ HTMLelement("select") }}, {{ HTMLelement("textarea") }}.

name は、 {{ domxref("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)では、 {{ domxref("document.createElement()") }}を使って作成されたDOM オブジェクトの name 属性は、設定および変更をすることができません。

仕様

W3C DOM 2 HTML Specification:

{{ languages( { "en" :"en/DOM/element.name", "fr": "fr/DOM/element.name", "pl": "pl/DOM/element.name" } ) }}