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()
.