Метод namedItem() DOM XML

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

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

В зависимости от типа документа поведение этого метода также может варьироваться:

  • Если документ является HTML-документом, этот метод сначала запрашивает узел с атрибутом id, соответствующим данному имени, если соответствующий атрибут id не существует, то запрашивает узел с атрибутом name, соответствующим данному имени.

    При поиске в HTML-документе этот метод не чувствителен к регистру.

  • Если документ является XHTML-документом, этот метод проверяет только узлы с идентификатором, соответствующим заданному имени.

    При поиске в HTML-документе этот метод чувствителен к регистру.

Синтаксис:

htmlcollectionObject.namedItem(name)
Параметр Описание
name Название узла или элемента, который нужно получить.

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

Возвращает элемент или узел с заданным свойством id или name. Если такой узел не найден в HTMLCollection, возвращает null.

Описание

В JavaScript HTMLCollection обрабатывается как связанный массив, и элемент name можно легко найти, используя синтаксис массива [].

Пример

var c = document.forms;		//Это объект HTMLCollection
var address = c.namedItem("address");	//Найти <form name="address">
var payment = c["payment"];		//Простее syntax: найти <form name="payment">
var login = c.login;		//Это также эффективно: найти <form name="login">