element.name

Résumé

name obtient ou définit l'attribut name d'un objet DOM. Il s'applique uniquement aux éléments suivants : anchor, applet, form, frame, iframe, image, input, map, meta, object, option, param, select et textarea.

Le nom ainsi obtenu peut être utilisé avec la méthode getElementsByName, dans un formulaire et dans la collection elements d'un formulaire. Lorsqu'il est utilisé avec un formulaire ou les éléments d'une collection, il peut ne concerner qu'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.