Metodo getElementsByTagName() del DOM XML
Definizione e utilizzo
Il metodo getElementsByTagName() restituisce un NodeList di tutti gli elementi con il nome specificato.
Sintassi:
getElementsByTagName(name)
| Parametro | Descrizione |
|---|---|
| name | Valore di stringa, che determina il nome del tag da cercare. Il valore "*" corrisponde a tutti i nodi. |
Spiegazione
Questo metodo esplora i discendenti degli elementi specificati, restituendo un array di nodi Element (in realtà un oggetto NodeList), che rappresenta tutti gli elementi documentali con il nome di tag specificato. L'ordine degli elementi nell'array è lo stesso dell'ordine in cui appaiono nel codice sorgente del documento.
Attenzione, l'interfaccia Document definisce anche il metodo getElementsByTagName(), che è simile a questo metodo, ma esplora l'intero documento invece di esplorare i figli di un elemento.
Esempio
In tutti gli esempi, utilizzeremo il file XML books.xml, e la funzione JavaScript loadXMLDoc().
Il seguente frammento di codice mostra tutti i valori degli elementi <title> nel file "books.xml":
xmlDoc=loadXMLDoc("books.xml");
x=xmlDoc.getElementsByTagName('title');
for (i=0;i<x.length;i++)
{
document.write(x[i].childNodes[0].nodeValue);
document.write("<br />");
}
L'output del codice sopra:
Everyday Italian Harry Potter XQuery Kick Start Learning XML
