Skip to main content

Visit Mozilla.org

DOM:element.name

z Mozilla Developer Center, polskiego centrum programistów Mozilli.

« Dokumentacja Gecko DOM

Spis treści

[edytuj] Podsumowanie

name pobiera lub ustawia atrybut name obiektu DOM. Ma zastosowanie tylko dla poniższych elementów: anchor, applet, form, frame, iframe, image, input, map, meta, object, option, param, select i textarea.

name można wykorzystać w metodzie getElementsByName, w obiekcie form i w kolekcji elements. Jeśli zostanie użyta dla formularza lub kolekcji elementów, właściwość tak może zwrócić jeden element lub ich kolekcję.

[edytuj] Składnia 

HTMLElement.name = string;
var elName = HTMLElement.name;

var kontrolka = HTMLFormElement.nazwaElementu;
var kolekcjaKontrolek = HTMLFormElement.elements.nazwaElementu;

[edytuj] Przykład 

<form action="" name="formA">
  <input type="text" value="foo">
</form>

<script type="text/javascript">

  // pobierz referncję do pierwszego elementu formularza
  var formElement = document.forms['formA'].elements[0];

  // nadaj mu nazwę
  formElement.name = 'inputA';

  // i wyświetl jego wartość
  alert(document.forms['formA'].elements['inputA'].value);
 
</script>

[edytuj] uwagi

W przeglądarce Internet Explorer (IE) nie można modyfikować właściwości name obiektów DOM utworzonych za pomocą createElement.

[edytuj] Specyfikacja

Specyfikacja W3C DOM 2 HTML:

Źródło: "http://developer.mozilla.org/pl/docs/DOM:element.name"