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