Документ: метод getElementsByName()

Базовая линия Широко доступна

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

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

Синтаксис

getElementsByName(name)

Параметры

name: Значение атрибута name искомого элемента (или элементов).

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

Живая NodeList коллекция, что означает, что она автоматически обновляется при добавлении или удалении новых элементов с тем же атрибутом name в документ.

Примеры

<!doctype html>
<html lang="en">
  <head>
    <title>Example: using document.getElementsByName</title>
  </head>
  <body>
    <input type="hidden" name="up" />
    <input type="hidden" name="down" />
  </body>
</html>

const up_names = document.getElementsByName("up");
console.log(up_names[0].tagName); // displays "INPUT"

Примечания

Атрибут name может быть применён только в (X)HTML-документах.

Возвращаемая NodeList коллекция содержит все элементы с заданным name, такие как <meta>, <object>, и даже элементы, которые вообще не поддерживают атрибут name.

Спецификации

Спецификация
HTML # dom-document-getelementsbyname-dev

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`getElementsByName`	1	12 До Edge 79 этот метод возвращал `HTMLCollection`, а не `NodeList`.	58 1–58 Поддерживается только для `HTMLDocument`, а не для всех `Document` объектов.	5	4 1–4 Поддерживается только для `HTMLDocument`, а не для всех `Document` объектов.	18	58 4–58 Поддерживается только для `HTMLDocument`, а не для всех `Document` объектов.	10.1	3.2 1–3.2 Поддерживается только для `HTMLDocument`, а не для всех `Document` объектов.	1.0	4.4

См. также

document.getElementById() для получения ссылки на элемент по его уникальному id
document.getElementsByTagName() для получения ссылок на элементы с одинаковым именем тега
document.querySelector() для получения ссылок на элементы через CSS-селекторы, такие как 'div.myclass'

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Document/getElementsByName