--- title: Element.name slug: Web/API/Element/name tags: - API - DOM - Element - NeedsBrowserCompatibility - NeedsUpdate - Property - Reference - Web translation_of: Web/API translation_of_original: Web/API/Element/name ---

{{ APIRef("DOM") }}

Summary

name recebe ou ajusta uma propriedade name de um objeto do DOM; ele se aplica somente aos seguintes elementos: {{ HTMLelement("a") }}, {{ HTMLelement("applet") }}, {{ HTMLelement("button") }}, {{ HTMLelement("form") }}, {{ HTMLelement("frame") }}, {{ HTMLelement("iframe") }}, {{ HTMLelement("img") }}, {{ HTMLelement("input") }}, {{ HTMLelement("map") }}, {{ HTMLelement("meta") }}, {{ HTMLelement("object") }}, {{ HTMLelement("param") }}, {{ HTMLelement("select") }} e {{ HTMLelement("textarea") }}.

Nota: A propriedade name não existe para outros elementos; diferente de tagName e nodeName, ela não é uma propriedade das interfaces {{domxref("Node")}}, {{domxref("Element")}} ou {{domxref("HTMLElement")}}.

name pode ser usada no método {{ domxref("document.getElementsByName()") }}, em um form ou com uma coleção de elementos de formulário. Ela pode retornar um único elemento ou uma coleção quando usada com um formulário ou elementos de coleção.

Sintaxe

HTMLElement.name = string;
var elName = HTMLElement.name;

var fControl = HTMLFormElement.elementName;
var controlCollection = HTMLFormElement.elements.elementName;

Exemplo

<form action="" name="formA">
  <input type="text" value="foo">
</form>

<script type="text/javascript">

  // Recebe uma referência ao primeiro elemento no formulário
  var formElement = document.forms['formA'].elements[0];

  // Fornece um name a ele
  formElement.name = 'inputA';

  // Exibe o valor do input
  alert(document.forms['formA'].elements['inputA'].value);

</script>

Notas

No Internet Explorer (IE), não é possível ajustar ou modificar a propriedade name de objetos do DOM criados com {{ domxref("document.createElement()") }}.

Especificação

Especificação W3C DOM 2 HTML: