Element.getElementsByTagName()

Il metodo Element.getElementsByTagName() ritorna una HTMLCollection dinamica di elementi con il tag name specificato. Vengono cercati tutti i discendenti dell'elemento specificato, ma non l'elemento stesso. L'elenco restituito è dinamico, il che significa che si aggiorna automaticamente con l'albero del DOM. Pertanto, non è necessario chiamare Element.getElementsByTagName() con lo stesso elemento e gli stessi argomenti ripetutamente se il DOM cambia tra le chiamate.

Quando viene chiamato su un elemento HTML in un documento HTML, getElementsByTagName converte in minuscolo l'argomento prima di cercarlo. Ciò non è desiderabile quando si cerca di abbinare elementi SVG camel-cased (come <linearGradient>) in un documento HTML. Invece, usa Element.getElementsByTagNameNS() (en-US), che preserva la conversione in minuscolo del nome del tag.

Element.getElementsByTagName è simile a Document.getElementsByTagName(), tranne per il fatto che cerca solo elementi discendenti dell'elemento specificato.

Sintassi

elements = element.getElementsByTagName(tagName)
  • elements è una HTMLCollection dinamica di elementi con un nome di tag corrispondente, nell'ordine in cui appaiono. Se non vengono trovati elementi, la HTMLCollection è vuota.
  • element è l'elemento da cui inizia la ricerca. Sono inclusi solo i discendenti dell'elemento, non l'elemento stesso.
  • tagName è il nome qualificato da cercare. La stringa speciale "*" rappresenta tutti gli elementi. Per compatibilità con XHTML, è necessario scriverlo in minuscolo.

Esempio

// Controlla lo stato di ogni cella in una tabella
const table = document.getElementById('forecast-table');
const cells = table.getElementsByTagName('td');

for (let cell of cells) {
  let status = cell.getAttribute('data-status');
  if (status === 'open') {
    // Prendi i dati
  }
}

Specifiche

Specifica Stato Commento
DOM
The definition of 'Element.getElementsByTagName()' in that specification.
Living Standard Modificato il valore di ritorno da NodeList a HTMLCollection
Document Object Model (DOM) Level 3 Core Specification
The definition of 'Element.getElementsByTagName()' in that specification.
Obsolete Nessun cambiamento da Document Object Model (DOM) Level 2 Core Specification
Document Object Model (DOM) Level 2 Core Specification
The definition of 'Element.getElementsByTagName()' in that specification.
Obsolete Nessun cambiamento da Document Object Model (DOM) Level 1 Specification
Document Object Model (DOM) Level 1 Specification
The definition of 'Element.getElementsByTagName()' in that specification.
Obsolete Definizione iniziale

Compatibilità con i browser

BCD tables only load in the browser