Element.getElementsByTagName()

di 3 collaboratori:

Questa traduzione è incompleta. Collabora alla traduzione di questo articolo dall’originale in lingua inglese.

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.

Nota: Mentre la specifica W3C DOM 3 Core dice che elementi è una Lista di nodi semplicemente perchè per un tentativo di ricevere la specificazione "core", non dipende dalla specificazione "html" in quel momento. Il DOM 4 draft dice che elementi è un HTMLCollection.

Gecko/Firefox attualmente ritorna una lista di nodi (Bug 162927) ma partendo dalla versione Gecko/Firefox 19, questo metodo ritorna un HTMLCollection (Bug 799464). Internet Explorer restituisce unacollezione HTML. WebKit restituisce una lista di nodi. Opera anche restituisce una lista di nodi,ma con un metodonamedItem implementato, che lo rende simile a una collezione HTML.

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

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 1.0 (Yes) 5.5 (Yes) (Yes)
getElementsByTagName("*") 1.0 (Yes) 6.0 (Yes) (Yes)
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support (Yes) (Yes) (Yes) (Yes) (Yes)

Specificazioni

Etichette del documento e nomi di chi ha collaborato alla sua stesura

Contributors to this page: teoli, AshfaqHossain, Ruggi
Ultima modifica di: teoli,
Nascondi barra laterale