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: