Element.name

Sumario

name obtiene o establece la propiedad del nombre de un objeto DOM; sólo se aplica a los siguientes elementos: <a>, <applet>, <button>, <form>, <frame>, <iframe>, <img>, <input>, <map>, <meta>, <object>, <param>, <select>, and <textarea>.

Nota: La propiedad name no esixte para otros elementos; a diferencia de tagName y nodeName, no es una propiedad de los modos de comunicación (interfaces) Node, Element or HTMLElement.

name puede ser utilizado en el métododocument.getElementsByName() , en una configuración y con la colección de elementos de la configuración. cuando utilizamos una configuración o  elementos de una colección, puede devolver un solo elemento o una colección.

Síntasix

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

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

Ejemplo

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

<script type="text/javascript">

  // Get a reference to the first element in the form
  var formElement = document.forms['formA'].elements[0];

  // Give it a name
  formElement.name = 'inputA';

  // Show the value of the input
  alert(document.forms['formA'].elements['inputA'].value);
 
</script>

Notas

En Internet Explorer (IE), la propiedad name de los objetos DOM , creada utilizandodocument.createElement() no puede ser establecida o modificada

Especificaciones

W3C DOM 2 HTML Specification: