Spec-Zone.ru › Web APIs

HTMLCollection: метод namedItem()

Базовая Широко поддерживается

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

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

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

В JavaScript, вместо вызова collection.namedItem("value"), вы также можете напрямую получить доступ к имени в коллекции, как collection["value"], если имя не совпадает с одним из существующих HTMLCollection свойств.

Синтаксис

namedItem(key)

Параметры

key

Строка, представляющая значение атрибута id или name искомого элемента.

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

Первый Element в коллекции HTMLCollection, соответствующий указанному key, или null, если такого нет. Всегда возвращает null если key является пустой строкой.

Пример

HTML

<div id="personal">
  <span name="title">Dr.</span>
  <span name="first-name">Carina</span>
  <span name="last-name">Anand</span>
  <span id="degree">(MD)</span>
</div>

JavaScript

const container = document.getElementById("personal");

// Returns the HTMLSpanElement with the name "title" if no such element exists null is returned
const titleSpan = container.children.namedItem("title");

// The following variants return undefined instead of null if there's no element with a matching name or id
const firstNameSpan = container.children["first-name"];
const lastNameSpan = container.children["last-name"];

// Returns the span element with the id "degree"
const degreeSpan = container.children.namedItem("degree");

const output = document.createElement("div");
output.textContent = `Result: ${titleSpan.textContent} ${firstNameSpan.textContent} ${lastNameSpan.textContent} ${degreeSpan.textContent}`;

container.insertAdjacentElement("afterend", output);

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

Спецификация
DOM
# dom-htmlcollection-nameditem-key

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

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
namedItem 1 12 1 ≤12.1 1 18 4 ≤12.1 1 1.0 4.4

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

Spec-Zone.ru

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