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: