element.name

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 :

Les traductions ne sont pas normatives.