document.getElementsByName

Sommario

Restituisce una lista di elementi con un dato nome all'interno del documento (X)HTML corrente.

Sintassi

elementi = document.getElementsByName(nome) 

• elementi è una NodeList di elementi
• nome è il valore dell'attributo name degli elementi

Esempi

// restituisce qualcosa per ogni div
//<div name="su">200</div> 
//<div name="su">145</div> 
//<div name="giu">146</div> 
//<div name="altro">178</div> 
div_su = document.getElementsByName("su"); 
dump(div_su.item(0).tagName); // restituisce "div"

Note

L'attributo nome è valido solo per un insieme limitato di elementi HTML, quindi getElementsByName() è applicabile solo a tali elementi.

Questo metodo inoltre è applicabile solo a documenti (X)HTML.

document.getElementsByName restituisce una NodeList di tutti gli elementi che hanno un dato valore nell'attributo name. Diversamente da getElementsByTagName, che usa il nome del tag stesso (per esempio DIV, P, etc), questo metodo si applica agli elementi che hanno un dato valore nell'attributo name.

Specifiche

DOM Level 2 HTML: getElementsByName