Element.name

Summary

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

Nota: A propriedade name n√£o existe para outros elementos; diferente de tagName e nodeName, ela n√£o √© uma propriedade das interfaces Node, Element ou HTMLElement.

name pode ser usada no m√©todo 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 document.createElement().

Especificação

Especificação W3C DOM 2 HTML: