Рекламации HTMLCollection елементи с определено име на маркер. Търсенето се извършва на целия документ, включително коренът. HTMLCollection върна жив, което означава, че автоматично се обновява, за да остане в синхрон с дървото DOM без да се налага да се обадя document.getElementByTagName () отново.

• елементи е живо HTMLCollection (като се вземат предвид бележките по-долу) са открити документи в реда, в който те се появяват в дървото.
• низ с името на представляващ името на елемента. Специалният низ "*" ви позволява да получите всички елементи.

Забележка: Последно W3C спец казва, че елементите са HTMLCollection; В същото време, този метод връща NodeList в WebKit браузъри. Вижте. Дървеница 14869 за повече информация.

В следващия пример, getElementByTagName () започва от самотен родител и търси рекурсивно отгоре-надолу на DOM, тъй като майка търси дъщерни елементи, отговарящи на параметъра име на маркер.

Имайте предвид, че когато един възел, който getElementsByTagName () не е бил причинен от документ възел. element.getElementsByTagName () метод се използва след факта.

бележки

Когато се извиква на HTML документ, getElementsByTagName () до по-ниски случай преди работа аргумента си. Това може да е изненада, когато се опитате да намерите съвпадение на camelCase SVG елементи в поддървото от документа за HTML. В такъв случай, може да е полезно document.getElementsByTagNameNS (). Вижте. Също бъг 499656.

document.getElementsByTagName () е подобна element.getElementsByTagName (). освен че търсенето обхваща целия документ.

спецификация