Returnează selecția HTML a elementelor cu numele etichetei specificat. Căutarea se efectuează pe tot documentul, inclusiv pe nodul rădăcină. HTMLCollecția returnată este în viață, ceea ce înseamnă că se actualizează automat pentru a rămâne în sincronizare cu arborele DOM, fără a mai trebui să apeleze din nou document.getElementByTagName ().
- elemente este un HTMLCollection viu (cu o notă de mai jos) găsit documente în ordinea în care acestea apar în arbore.
- numele este numele elementului. Un șir special "*" vă permite să obțineți toate elementele.
Notă: ultima specificație W3C spune că elementele sunt un HTMLCollection; Între timp, această metodă returnează NodeList în browserele WebKit. Consultați eroarea 14869 pentru mai multe informații.
În exemplul următor, getElementByTagName () pornește de la un element părinte separat și caută recursiv de sus în jos pe DOM începând cu elementul părinte privindu-se elementele copil pentru potrivirea etichetei cu parametrul nume.
Rețineți că atunci când nodul în care a fost apelat getElementsByTagName () nu este un nod de document. De fapt, metoda element.getElementsByTagName () este utilizată.
notițe
Atunci când este apelat pe documentul HTML, getElementsByTagName () convertește argumentul său la literele mici înainte de lucrare. Acest lucru poate fi neașteptat când încercați să se potrivească pentru elementele SVG camelCase într-un subtree al unui document HTML. În acest caz, document.getElementsByTagNameNS () poate fi util. Consultați și Eroare 499656.
document.getElementsByTagName () este similar cu element.getElementsByTagName (). cu excepția faptului că căutarea acoperă întregul document.