getElementsByTagName()

Поддержка браузерами


12.0+	6.0+	3.0+	1.0+	9.5+	3.0+

Описание

Метод document.getElementsByTagName() возвращает массив, содержащий ссылки на все элементы указанного типа, находящиеся в HTML-документе. Ссылки на элементы в массиве будут представлены в том же порядке, в каком эти элементы расположены в исходном коде документа.

Если в качестве передаваемого аргумента указать символ "*" (звёздочка), метод вернёт все элементы, расположенные в HTML-документе.

Метод getElementsByTagName() можно также использовать для получения ссылок на элементы, которые являются потомками определённого элемента, например:

var div = document.getElementById("myDiv");
div.getElementsByTagName("span");

В этом случае метод вернет все элементы <span>, являющиеся потомками элемента <div> с идентификатором "myDiv".

Примечание: вместо метода getElementsByTagName() можно использовать метод querySelectorAll(), позволяющий проводить поиск элементов используя допустимые CSS селекторы (включая селекторы типа).

Синтаксис

document.getElementsByTagName(имяТега)

Аргументы

имяТега: строка, представляющая собой имя элемента.

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

массив элементов указанного типа, находящихся в HTML-документе.

Пример

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>Название документа</title>
</head>
<body>

  <p>Нажмите кнопку, чтобы изменить текст в этом абзаце.</p>

  <button onclick="foo()">Попробовать</button>

  <script>
    function foo() {
      document.getElementsByTagName("p")[0].innerHTML="Hello World";
    }
  </script>

</body>
</html>

Попробовать »