Element.getElementsByTagName()

Ritorna un lista di elementi con il nome del tag dato. La sottostruttura dell'elemento viene ricercato, escludendo l'elemento stesso. La lista che viene fuori è viva, ciò significa che si aggiorna automaticamente con l'albero del DOM

Sintassi

elementi = elemento.getElementsByTagName(NomedelTag)

• elementi è una Lista di nodi viva (però vedi la nota sotto) degli elementi trovati nell'ordine che appaiono nella sottostruttura. Se nessun elemento è stato trovato la lista dei nodi è vuota.
• elemento è l'elemento da cui la ricerca parte. Notare che solo i discendenti di questi elementi solo inclusi nella ricerca, ma non l'elemento stesso.
• NomedelTag è il nome del tag su cui eseguire la ricerca.La stringa speciale "*" rappresenta tutti gli elementi. Per compabilità con l'XHTML, usare solo minuscole.

Esempio

// controlla l'allineamento di un numero di celle in una tabella. 
var table = document.getElementById("forecast-table"); 
var cells = table.getElementsByTagName("td"); 
for (var i = 0; i < cells.length; i++) { 
    var status = cells[i].getAttribute("data-status"); 
    if ( status == "open" ) { 
        // grab the data 
    }
}

Note

Quando chiamato su un elemento HTML in un documento HTML, getElementsByTagName mette in minuscolo il nome del tag automaticamente prima di procedere. Questo è auspicabile quando si prova ad abbinare elementi camelCase SVG in un sottostruttura nel documento HTML. element.getElementsByTagNameNS lavora così in questo caso. Vedi anche bug 499656.

element.getElementsByTagName è simile a document.getElementsByTagName, slo che la sua ricerca è ristretta a quegli elementi che sono discendenti di altri elementi specificati.

Compatibilità fra browser

Specificazioni

• DOM Level 2 Core: Element.getElementsByTagName
• HTML 5: APIs in HTML documents