name
obtient ou définit la propriété name
(nom) d'un élément dans le DOM. Il s'applique uniquement aux éléments suivants : <a>
, <applet>
, <button>
, <form>
, <frame>
, <iframe>
, <img>
, <input>
, <map>
, <meta>
, <object>
, <param>
, <select>
et <textarea>
.
Note : La propriété name
n'existe pas pour d'autres éléments ; contrairement à tagName
et nodeName
, ce n'est pas une propriété des interfaces Node
, Element
ou HTMLElement
.
Le name
peut être utilisé avec la méthode document.getElementsByName()
, dans un formulaire et dans la collection elements
d'un formulaire. Lorsqu'il est utilisé avec un formulaire ou les collections d'éléments, il peut renvoyer un seul élément ou une collection d'éléments.
Syntaxe
HTMLElement.name = string; var elName = HTMLElement.name; var fControl = HTMLFormElement.elementName; var controlCollection = HTMLFormElement.elements.elementName;
Exemple
<form action="" name="formA"> <input type="text" value="foo"> </form> <script type="text/javascript"> // Obtient une référence au premier élément du formulaire var formElement = document.forms['formA'].elements[0]; // Lui donne un nom formElement.name = 'inputA'; // Affiche la valeur du champ alert(document.forms['formA'].elements['inputA'].value); </script>
Notes
Dans Internet Explorer, la propriété name
des objets DOM créés à l'aide de createElement
ne peut être définie ou modifiée.
Spécification
Spécification DOM 2 HTML du W3C :
- Anchor — traduction
- Applet — traduction
- Form — traduction
- Frame — traduction
- iFrame — traduction
- Image — traduction
- Input — traduction
- Map — traduction
- Meta — traduction
- Object — traduction
- Option — traduction
- Param — traduction
- Select — traduction
- Textarea — traduction
Les traductions ne sont pas normatives.