Метод getElementsByName() класса HTML DOM Document

Определение и использование

getElementsByName() Метод возвращает набор элементов с указанным именем.

getElementsByName() Метод возвращает NodeList.

NodeList

NodeList Это набор узлов, аналогичный массиву (списку).

Элементы списка можно получить по индексу. Индекс начинается с 0.

length Возвращает количество узлов в списке элементов.

Дополнительная информация:

Метод getElementById()

Метод getElementsByTagName()

Метод getElementsByClassName()

Метод querySelector()

Метод querySelectorAll()

Руководство NodeList

Пример

Пример 1

Получите все элементы с именем "fname":

let elements = document.getElementsByName("fname");

Попробуйте сами

Пример 2

Возврат количества элементов с name="animal":

let num = document.getElementsByName("animal").length;

Попробуйте сами

Пример 3

Проверьте все элементы <input> с type="checkbox" и именем "animal":

const collection = document.getElementsByName("animal");
for (let i = 0; i < collection.length; i++) {
  if (collection[i].type == "checkbox") {
    collection[i].checked = true;
  }
}

Попробуйте сами

Синтаксис

document.getElementsByName(name)

Параметр

Параметр Описание
name Обязателен. Значение атрибута name элемента.

Возвратное значение

Тип Описание
Объект

Объект NodeList.

Коллекция элементов с указанным именем.

Сортируются по порядку的出现 элементов в документе.

Поддержка браузеров

document.getElementsByName() Это функция DOM Level 1 (1998).

Все браузеры поддерживают его:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Поддержка 9-11 Поддержка Поддержка Поддержка Поддержка