Возвращает
пример
var paragraphs = document.getElementByTagName('p');
Приведенный выше пример получает ссылку на коллекцию элементов p
в текущем документе и сохраняет ее в переменных абзацах . Возвращенная коллекция является действующей , что означает, что изменения в HTML-коде, который она представляет, немедленно отражаются в коллекции без необходимости извлекать ее снова.
Этот метод также можно использовать контекстуально, чтобы получить ссылку на элементы, которые находятся внутри определенного элемента, например:
var items = list.getElementByTagName('li');
Поэтому, если бы список в этом примере был элементом ul
, переменная items ссылалась бы на коллекцию всех элементов li
, находящихся внутри этого списка.
Элементы извлекаются в линейном порядке, в котором они появляются в документе, т.е. они соответствуют плоскому виду DOM. Так что, если в предыдущем примере список соответствовал этому HTML:
<UL> <li> Брынза <UL> <Li> Эдам </ li> <Li> Гауда </ li> <Li> Чеддер </ li> </ UL> </ Li> <Li> Хамса <UL> <Li> прошутто </ li> <Li> Парма </ li> <Li> Салями </ li> </ UL> </ Li> </ UL>
Возвращенная коллекция будет в следующем порядке:
-
[0]
Сыры -
[1]
Эдам -
[2]
Гауда -
[3]
Чеддер -
[4]
Хэмс -
[5]
Прошутто -
[6]
Парма -
[7]
салями
аргументы
имя ( DOMString )
обязательно
tagName
элементов для сопоставления. Значение * соответствует всем элементам.
Описание
Получить упорядоченный список всех элементов с заданным именем тега, которые являются потомками этого документа или элемента, в линейном порядке, в котором они появляются в дереве DOM.
NodeList
коллекция — это NodeList
— упорядоченная коллекция узлов, нумерованная с нуля. Если нет подходящих элементов, то это коллекция с нулевыми элементами.
Коллекция не является массивом
Несмотря на то, что коллекция выглядит как массив, она не является массивом — хотя вы можете перебирать ее и ссылаться на ее элементы как массив, вы не можете использовать методы Array, такие как push или pop для нее.
Возвращаемое значение
NodeList, содержащий все совпадающие элементы; если элементы не найдены, это будет список с нулевыми членами.