Статьи

getElementsByTagName (основной метод W3C DOM)

Возвращает

NodeList

пример

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> 

Возвращенная коллекция будет в следующем порядке:

  1. [0] Сыры
  2. [1] Эдам
  3. [2] Гауда
  4. [3] Чеддер
  5. [4] Хэмс
  6. [5] Прошутто
  7. [6] Парма
  8. [7] салями

аргументы

имя ( DOMString ) обязательно
tagName элементов для сопоставления. Значение * соответствует всем элементам.

Описание

Получить упорядоченный список всех элементов с заданным именем тега, которые являются потомками этого документа или элемента, в линейном порядке, в котором они появляются в дереве DOM.

NodeList коллекция — это NodeList — упорядоченная коллекция узлов, нумерованная с нуля. Если нет подходящих элементов, то это коллекция с нулевыми элементами.

Коллекция не является массивом

Несмотря на то, что коллекция выглядит как массив, она не является массивом — хотя вы можете перебирать ее и ссылаться на ее элементы как массив, вы не можете использовать методы Array, такие как push или pop для нее.

Возвращаемое значение

NodeList, содержащий все совпадающие элементы; если элементы не найдены, это будет список с нулевыми членами.