Spec-Zone.ru › Web APIs

HTMLFormControlsCollection: метод namedItem()

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

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

  • Узнать больше
  • Полная совместимость
  • Отправить обратную связь

Метод HTMLFormControlsCollection.namedItem() возвращает RadioNodeList или Element в коллекции, чьи name или id совпадают с указанным именем, или null , если такой элемент не найден.

Обратите внимание, что эта версия namedItem() скрывает унаследованную от HTMLCollection. Как и та, в JavaScript, использование синтаксиса массивов с String, например, collection["value"] равносильно collection.namedItem("value").

Синтаксис

namedItem(name)
[name]

Параметры

name

Строка, которая будет использоваться для сопоставления с атрибутами name или id элементов управления в этом объекте HTMLFormControlsCollection.

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

  • RadioNodeList, Element или null.

Примеры

Использование namedItem()

HTML

<form>
  <label for="notes">Notes:</label>
  <input id="notes" name="my-form-control" type="text" />

  <label for="start">Start date:</label>
  <input id="start" name="my-form-control" type="date" />
</form>

<div id="output"></div>

JavaScript

const form = document.querySelector("form");
const items = form.elements.namedItem("my-form-control");

const output = document.querySelector("#output");
const itemIDs = Array.from(items)
  .map((item) => `"${item.id}"`)
  .join(", ");
output.textContent = `My items: ${itemIDs}`;

Результат

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

Спецификация
HTML
# dom-htmlformcontrolscollection-nameditem-dev

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

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome для Android Firefox для Android Opera для Android Safari на iOS Samsung Internet WebView для Android
namedItem 1 12 33
27–33Возвращался NodeList вместо RadioNodeList.
≤12.1 3 18 33
27–33Возвращался NodeList вместо RadioNodeList.
≤12.1 1 1.0 4.4

См. также

  • HTMLCollection.namedItem, который он заменяет

© 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/HTMLFormControlsCollection/namedItem

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API