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(), 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

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
getElementsByTagNameChrome Full support 1
Notes
Full support 1
Notes
Notes Initially, this method was returning a NodeList; it was then changed to reflect the spec change.
Edge Full support 12Firefox Full support Yes
Notes
Full support Yes
Notes
Notes Prior to Firefox 19, this method was returning a NodeList; it was then changed to reflect the change in the spec.
IE Full support 5.5Opera Full support Yes
Notes
Full support Yes
Notes
Notes Initially, this method was returning a NodeList; it was then changed to reflect the spec change.
Safari Full support 6
Notes
Full support 6
Notes
Notes Initially, this method was returning a NodeList; it was then changed to reflect the spec change.
WebView Android Full support YesChrome Android Full support YesFirefox Android Full support Yes
Notes
Full support Yes
Notes
Notes Prior to Firefox 19, this method was returning a NodeList; it was then changed to reflect the change in the spec.
Opera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes
getElementsByTagName(*)Chrome Full support 1Edge Full support YesFirefox Full support YesIE Full support 6Opera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support Yes
Notes
Full support Yes
Notes
Notes Prior to Firefox 19, this method was returning a NodeList; it was then changed to reflect the change in the spec.
Opera Android Full support YesSafari iOS Full support YesSamsung Internet Android ?

Legend

Full support  
Full support
Compatibility unknown  
Compatibility unknown
See implementation notes.
See implementation notes.